{
    "openapi": "3.0.2",
    "info": {
        "title": "Redis Agent Memory API",
        "version": "1.0.0",
        "description": "API for storing, retrieving, and searching Redis Agent Memory session memory and long-term memory.\n\nAuthentication depends on your deployment. Use the credential issued for your Agent Memory service or store. For self-managed deployments, see the self-managed Agent Memory guide for authentication options.\n"
    },
    "paths": {
        "/iris/data/v1/agent-memory/health/live": {
            "get": {
                "description": "Reports that this API process can answer requests, independently of downstream dependencies.",
                "operationId": "GetServiceLiveness",
                "responses": {
                    "200": {
                        "description": "GetServiceLiveness 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetServiceLivenessResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "ServiceUnavailableError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ServiceUnavailableErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "security": []
            }
        },
        "/iris/data/v1/agent-memory/health/ready": {
            "get": {
                "description": "Evaluates the same serving dependencies as the operational readiness probe. Returns 503 without dependency details when the service cannot serve requests.",
                "operationId": "GetServiceReadiness",
                "responses": {
                    "200": {
                        "description": "GetServiceReadiness 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetServiceReadinessResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "ServiceUnavailableError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ServiceUnavailableErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "security": []
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/document-ingestions": {
            "post": {
                "description": "Submit one revisioned document for extraction.",
                "operationId": "CreateDocumentIngestion",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateDocumentIngestionRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "202": {
                        "description": "CreateDocumentIngestion 202 response",
                        "headers": {
                            "Location": {
                                "schema": {
                                    "type": "string"
                                },
                                "required": true
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateDocumentIngestionResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/document-ingestions/{ingestionId}": {
            "get": {
                "operationId": "GetDocumentIngestion",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "ingestionId",
                        "in": "path",
                        "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 36,
                            "minLength": 36,
                            "pattern": "^ing_[0-9a-f]{32}$",
                            "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetDocumentIngestion 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetDocumentIngestionResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/document-ingestions/{ingestionId}/outputs": {
            "get": {
                "operationId": "ListDocumentIngestionOutputs",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "ingestionId",
                        "in": "path",
                        "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 36,
                            "minLength": 36,
                            "pattern": "^ing_[0-9a-f]{32}$",
                            "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Maximum number of memory IDs to return. Defaults to 50. Allowed range: 1-100.",
                        "schema": {
                            "type": "integer",
                            "maximum": 100,
                            "minimum": 1,
                            "description": "Maximum number of memory IDs to return. Defaults to 50. Allowed range: 1-100.",
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListDocumentIngestionOutputs 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListDocumentIngestionOutputsResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/health": {
            "get": {
                "description": "Returns read-only health for applicable store-scoped Agent Memory features.",
                "operationId": "StoreHealth",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "StoreHealth 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/StoreHealthResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Store Health"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/ingestion-hook-events": {
            "get": {
                "description": "List hook decisions in stable newest-first order. Pages can be empty after owner filtering; continue while nextCursor is present.",
                "operationId": "ListIngestionHookStatuses",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "maximum": 100,
                            "minimum": 1,
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListIngestionHookStatuses 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListIngestionHookStatusesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Ingestion Hooks"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/ingestion-hook-events/{eventId}": {
            "get": {
                "description": "Read a hook decision and application status. Requires authenticated store access and, when enforced, matching owner scope. Content and secrets are never returned.",
                "operationId": "GetIngestionHookStatus",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "eventId",
                        "in": "path",
                        "schema": {
                            "type": "string"
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetIngestionHookStatus 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetIngestionHookStatusResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Ingestion Hooks"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories": {
            "post": {
                "description": "Creates long-term memories in bulk. A memoryId that already exists is rejected for that record (reported in errors) and the stored memory is left unchanged; change a memory with UpdateLongTermMemory. Records without namespaceId stay un-namespaced. Automatic routing does not place them in a shared namespace. An explicit namespaceId must pass destination admission and is never rerouted. Admission failures are reported per record in errors.",
                "operationId": "BulkCreateLongTermMemories",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkCreateLongTermMemoriesRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "201": {
                        "description": "BulkCreateLongTermMemories 201 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkCreateLongTermMemoriesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/bulk-delete": {
            "post": {
                "description": "Deletes long-term memories in bulk by their IDs.",
                "operationId": "BulkDeleteLongTermMemories",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/BulkDeleteLongTermMemoriesRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "BulkDeleteLongTermMemories 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BulkDeleteLongTermMemoriesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/move": {
            "post": {
                "description": "Moves long-term memories to an explicit namespaceId, or automatically routes a memory that is already in a shared namespace when namespaceId is omitted. Personal and un-namespaced memories are not automatic-routing candidates and keep their current placement with a per-item error. If routing is disabled or no shared destination qualifies, the memory also keeps its current placement and receives a per-item error. An explicit destination must pass admission and is never rerouted. Returns 409 when the explicit destination is archived; automatic routing and admission failures are reported per item in errors.",
                "operationId": "MoveLongTermMemories",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MoveLongTermMemoriesRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "MoveLongTermMemories 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/MoveLongTermMemoriesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/search": {
            "post": {
                "description": "Runs a semantic search on long-term memory with filtering options.",
                "operationId": "SearchLongTermMemory",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SearchLongTermMemoryRequestContent"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "SearchLongTermMemory 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SearchLongTermMemoryResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/{memoryId}": {
            "get": {
                "description": "Returns a long-term memory by its ID.",
                "operationId": "GetLongTermMemory",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "The memory record ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The memory record ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetLongTermMemory 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetLongTermMemoryResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            },
            "patch": {
                "description": "Partially updates a long-term memory by its ID. The merged record must pass admission at its destination. Updates never select a different destination automatically. Namespace-only updates preserve the current expiration and are allowed for document-managed memories; their extracted content remains protected.",
                "operationId": "UpdateLongTermMemory",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateLongTermMemoryRequestContent"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "The memory record ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The memory record ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "UpdateLongTermMemory 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UpdateLongTermMemoryResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "PreconditionFailedError 412 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PreconditionFailedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            },
            "put": {
                "description": "Creates or fully replaces one manually managed memory, including custom attributes. Omitted optional fields are cleared; memoryType defaults to semantic. Replacement preserves creation time and restarts the store TTL. Destination admission and ownership checks apply. A concurrent write can return a conflict or not-found error; retry after reading the current record. An idempotencyKey replays the saved result during the retry window (at most 24 hours, capped by the store memory TTL); expectedRevision guards replacement against concurrent changes.",
                "operationId": "UpsertLongTermMemory",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpsertLongTermMemoryRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "UpsertLongTermMemory 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UpsertLongTermMemoryResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "PreconditionFailedError 412 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PreconditionFailedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/{memoryId}/fields": {
            "patch": {
                "description": "Atomically updates a custom-typed long-term memory's text and/or attributes, scoped to the caller's bound memory type. New text must pass destination admission before the update is applied.",
                "operationId": "UpdateLongTermMemoryFields",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateLongTermMemoryFieldsRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "The memory record ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The memory record ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "UpdateLongTermMemoryFields 200 response"
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "PreconditionFailedError 412 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PreconditionFailedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/{memoryId}/sources": {
            "get": {
                "description": "Pages source links for one long-term memory. Tokens bind this query and expire.",
                "operationId": "ListMemorySourceLinks",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "maximum": 100,
                            "minimum": 1,
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListMemorySourceLinks 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListMemorySourceLinksResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/memories/{memoryId}/sources/{sourceId}/evidence": {
            "get": {
                "description": "Pages extraction evidence for one source of a memory, in append order. Tokens bind the store, current owner, memory and source, and expire.",
                "operationId": "ListMemorySourceEvidence",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "memoryId",
                        "in": "path",
                        "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "required": true
                    },
                    {
                        "name": "sourceId",
                        "in": "path",
                        "description": "Stable source identifier for one revisioned origin in a store.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[a-zA-Z0-9-]+$",
                            "description": "Stable source identifier for one revisioned origin in a store."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "maximum": 100,
                            "minimum": 1,
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListMemorySourceEvidence 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListMemorySourceEvidenceResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/namespace-routing": {
            "get": {
                "description": "Returns the store's namespace routing policy. An empty disabled policy is returned when none has been saved.",
                "operationId": "GetNamespaceRouting",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetNamespaceRouting 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetNamespaceRoutingResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            },
            "put": {
                "description": "Replaces the store's namespace routing policy.",
                "operationId": "PutNamespaceRouting",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PutNamespaceRoutingRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "PutNamespaceRouting 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PutNamespaceRoutingResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/namespaces": {
            "get": {
                "description": "Lists namespace roots or direct children.",
                "operationId": "ListNamespaces",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "parentId",
                        "in": "query",
                        "description": "List direct children of this namespace. Omit to list roots.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "List direct children of this namespace. Omit to list roots."
                        }
                    },
                    {
                        "name": "scope",
                        "in": "query",
                        "description": "Restrict root results to one scope. Cannot be combined with parentId.",
                        "schema": {
                            "$ref": "#/components/schemas/NamespaceScope"
                        }
                    },
                    {
                        "name": "ownerId",
                        "in": "query",
                        "description": "Restrict personal root results to an owner. Cannot be combined with parentId; ignored for shared roots.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Restrict personal root results to an owner. Cannot be combined with parentId; ignored for shared roots."
                        }
                    },
                    {
                        "name": "sortBy",
                        "in": "query",
                        "description": "Field to sort by. Defaults to id. Name sorts by the indexed display name using Redis text collation, not the namespace path. Equal values are ordered by ID ascending.",
                        "schema": {
                            "$ref": "#/components/schemas/NamespaceSortBy"
                        }
                    },
                    {
                        "name": "sortOrder",
                        "in": "query",
                        "description": "Sort direction. Defaults to asc. Use the same sort options for each page; concurrent changes can shift offset-based pages.",
                        "schema": {
                            "$ref": "#/components/schemas/NamespaceSortOrder"
                        }
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Maximum number of namespaces to return. Defaults to 100. Allowed range: 1-200.",
                        "schema": {
                            "type": "integer",
                            "default": 100,
                            "maximum": 200,
                            "minimum": 1,
                            "description": "Maximum number of namespaces to return. Defaults to 100. Allowed range: 1-200.",
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque token from a previous response for the next page.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque token from a previous response for the next page."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListNamespaces 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListNamespacesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            },
            "post": {
                "description": "Creates a namespace resource as a root, direct child, or explicit hierarchy path. Returns 409 when an active or archived namespace already occupies the requested location.",
                "operationId": "CreateNamespace",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateNamespaceRequestContent"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "201": {
                        "description": "CreateNamespace 201 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateNamespaceResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/namespaces/{namespaceId}": {
            "delete": {
                "description": "Deletes an empty leaf namespace. Returns 409 when the namespace has children or memory placements, or when it changed concurrently.",
                "operationId": "DeleteNamespace",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "namespaceId",
                        "in": "path",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "204": {
                        "description": "DeleteNamespace 204 response"
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            },
            "get": {
                "description": "Gets one namespace by its canonical ID.",
                "operationId": "GetNamespace",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "namespaceId",
                        "in": "path",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetNamespace 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetNamespaceResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            },
            "patch": {
                "description": "Renames or archives a namespace. Returns 409 when the namespace changed concurrently, an active or archived sibling already uses the requested name, or the namespace is archived.",
                "operationId": "UpdateNamespace",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateNamespaceRequestContent"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "namespaceId",
                        "in": "path",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "UpdateNamespace 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UpdateNamespaceResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Namespaces"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/sessions": {
            "get": {
                "description": "Returns paginated session rows with metadata and caller-selected order.",
                "operationId": "ListSessions",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "description": "Maximum number of sessions to return. Defaults to 100. Allowed range: 1-200.",
                        "schema": {
                            "type": "integer",
                            "default": 100,
                            "maximum": 200,
                            "minimum": 1,
                            "description": "Maximum number of sessions to return. Defaults to 100. Allowed range: 1-200.",
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque token from a previous response for the next page. Bound to the effective filters and sort.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque token from a previous response for the next page. Bound to the effective filters and sort."
                        }
                    },
                    {
                        "name": "ownerId",
                        "in": "query",
                        "description": "Filter sessions by owner. The owner of a session is the actorId of its first event. Matching is exact and case-sensitive. Combined with namespaceId using AND. Mutually exclusive with includeAll.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Filter sessions by owner. The owner of a session is the actorId of its first event. Matching is exact and case-sensitive. Combined with namespaceId using AND. Mutually exclusive with includeAll."
                        }
                    },
                    {
                        "name": "namespaceId",
                        "in": "query",
                        "description": "Filter by stable namespace ID. Combined with ownerId using AND. Mutually exclusive with includeAll.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Filter by stable namespace ID. Combined with ownerId using AND. Mutually exclusive with includeAll."
                        }
                    },
                    {
                        "name": "includeAll",
                        "in": "query",
                        "description": "Set to true to list all visible sessions. Required when no filter is given; mutually exclusive with filters.",
                        "schema": {
                            "type": "boolean",
                            "description": "Set to true to list all visible sessions. Required when no filter is given; mutually exclusive with filters."
                        }
                    },
                    {
                        "name": "sortBy",
                        "in": "query",
                        "description": "Sort field. Defaults to updatedAt.",
                        "schema": {
                            "$ref": "#/components/schemas/SessionListSortBy"
                        }
                    },
                    {
                        "name": "sortOrder",
                        "in": "query",
                        "description": "Sort direction. Defaults to desc for timestamps and asc for sessionId.",
                        "schema": {
                            "$ref": "#/components/schemas/SessionListSortOrder"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListSessions 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListSessionsResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            },
            "post": {
                "description": "Creates a session with its first event. If sessionId is omitted, the server generates one. A sessionId that already exists is refused with 409 and the session is left unchanged; use AddSessionEvent to append to an existing session.",
                "operationId": "CreateSession",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSessionRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "201": {
                        "description": "CreateSession 201 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateSessionResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/sessions/{sessionId}": {
            "delete": {
                "description": "Deletes the session memory for a session.",
                "operationId": "DeleteSessionMemory",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "sessionId",
                        "in": "path",
                        "description": "The session ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The session ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "204": {
                        "description": "DeleteSessionMemory 204 response"
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            },
            "get": {
                "description": "Returns the session memory for a session.",
                "operationId": "GetSessionMemory",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "sessionId",
                        "in": "path",
                        "description": "The session ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The session ID."
                        },
                        "required": true
                    },
                    {
                        "name": "includeSummarisedEvents",
                        "in": "query",
                        "description": "When true, the response includes events that have already been covered by the session summary and have not yet been cleaned up. This flag is not expected to be set under normal usage.",
                        "schema": {
                            "type": "boolean",
                            "description": "When true, the response includes events that have already been covered by the session summary and have not yet been cleaned up. This flag is not expected to be set under normal usage."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetSessionMemory 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetSessionMemoryResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/sessions/{sessionId}/events": {
            "post": {
                "description": "Appends a single event to a session. Creates the session if it does not exist.",
                "operationId": "AddSessionEvent",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/AddSessionEventRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "sessionId",
                        "in": "path",
                        "description": "The session ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The session ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "201": {
                        "description": "AddSessionEvent 201 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AddSessionEventResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "IngestionHookStoppedError 422 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookStoppedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "IngestionHookRetryError 503 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/IngestionHookRetryErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/sessions/{sessionId}/events/{eventId}": {
            "delete": {
                "description": "Deletes a single event from a session by event ID.",
                "operationId": "DeleteSessionEvent",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "sessionId",
                        "in": "path",
                        "description": "The session ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The session ID."
                        },
                        "required": true
                    },
                    {
                        "name": "eventId",
                        "in": "path",
                        "description": "The event ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 36,
                            "minLength": 36,
                            "pattern": "^evt_[0-9a-f]{32}$",
                            "description": "The event ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "204": {
                        "description": "DeleteSessionEvent 204 response"
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            },
            "get": {
                "description": "Returns a single event from a session by event ID.",
                "operationId": "GetSessionEvent",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "The store instance ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "The store instance ID."
                        },
                        "required": true
                    },
                    {
                        "name": "sessionId",
                        "in": "path",
                        "description": "The session ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "The session ID."
                        },
                        "required": true
                    },
                    {
                        "name": "eventId",
                        "in": "path",
                        "description": "The event ID.",
                        "schema": {
                            "type": "string",
                            "maxLength": 36,
                            "minLength": 36,
                            "pattern": "^evt_[0-9a-f]{32}$",
                            "description": "The event ID."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetSessionEvent 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetSessionEventResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Session Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/sources/{sourceId}/memories": {
            "get": {
                "description": "Pages memories linked to one source. A source link does not grant access to a memory in another owner or namespace.",
                "operationId": "ListSourceMemories",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "sourceId",
                        "in": "path",
                        "description": "Stable source identifier for one revisioned origin in a store.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[a-zA-Z0-9-]+$",
                            "description": "Stable source identifier for one revisioned origin in a store."
                        },
                        "required": true
                    },
                    {
                        "name": "ownerId",
                        "in": "query",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "maximum": 100,
                            "minimum": 1,
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListSourceMemories 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListSourceMemoriesResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "423": {
                        "description": "ResourceSuspendedError 423 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ResourceSuspendedErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Long-Term Memory"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/summary-views": {
            "get": {
                "description": "Lists Summary View definitions and high-level state. Partition values are not included.",
                "operationId": "ListSummaryViews",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "default": 100,
                            "maximum": 100,
                            "minimum": 1,
                            "format": "int32"
                        }
                    },
                    {
                        "name": "cursor",
                        "in": "query",
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`.",
                        "schema": {
                            "type": "string",
                            "maxLength": 1024,
                            "minLength": 1,
                            "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "ListSummaryViews 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListSummaryViewsResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            },
            "post": {
                "description": "Creates a Summary View definition and asynchronously enqueues its initial reconciliation.",
                "operationId": "CreateSummaryView",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateSummaryViewRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "201": {
                        "description": "CreateSummaryView 201 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateSummaryViewResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "SummaryViewQuotaError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SummaryViewQuotaErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/summary-views/{viewId}": {
            "delete": {
                "description": "Marks a Summary View deleting and asynchronously removes its schedule and materializations in bounded batches. Repeated requests are idempotent.",
                "operationId": "DeleteSummaryView",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "viewId",
                        "in": "path",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^sv_[0-9a-f]{32}$",
                            "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "202": {
                        "description": "DeleteSummaryView 202 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DeleteSummaryViewResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            },
            "get": {
                "description": "Returns one Summary View definition without partition values.",
                "operationId": "GetSummaryView",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "viewId",
                        "in": "path",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^sv_[0-9a-f]{32}$",
                            "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetSummaryView 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetSummaryViewResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            },
            "patch": {
                "description": "Updates mutable Summary View fields. Source is immutable. Material changes increment definitionVersion; name- or description-only changes do not enqueue refresh work.",
                "operationId": "UpdateSummaryView",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdateSummaryViewRequestContent"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "viewId",
                        "in": "path",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^sv_[0-9a-f]{32}$",
                            "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "200": {
                        "description": "UpdateSummaryView 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UpdateSummaryViewResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "SummaryViewQuotaError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SummaryViewQuotaErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/summary-views/{viewId}/refresh": {
            "post": {
                "description": "Asynchronously enqueues one exact partition refresh or a complete view reconciliation. It never performs generation synchronously.",
                "operationId": "RefreshSummaryView",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/RefreshSummaryViewRequestContent"
                            }
                        }
                    },
                    "required": true
                },
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "viewId",
                        "in": "path",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^sv_[0-9a-f]{32}$",
                            "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    }
                ],
                "responses": {
                    "202": {
                        "description": "RefreshSummaryView 202 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/RefreshSummaryViewResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "SummaryViewQuotaError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/SummaryViewQuotaErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            }
        },
        "/iris/data/v1/agent-memory/stores/{storeId}/summary-views/{viewId}/result": {
            "get": {
                "description": "Returns one authorized exact Summary View partition after validating its contributing source records. Invalid output is withheld while repair is pending.",
                "operationId": "GetSummaryViewResult",
                "parameters": [
                    {
                        "name": "storeId",
                        "in": "path",
                        "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^st_[0-9a-f]{32}$",
                            "description": "Server-generated store identifier: st_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "viewId",
                        "in": "path",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^sv_[0-9a-f]{32}$",
                            "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                        },
                        "required": true
                    },
                    {
                        "name": "ownerId",
                        "in": "query",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                        }
                    },
                    {
                        "name": "sessionId",
                        "in": "query",
                        "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                        }
                    },
                    {
                        "name": "namespaceId",
                        "in": "query",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters.",
                        "schema": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                        }
                    },
                    {
                        "name": "memoryType",
                        "in": "query",
                        "description": "Identifier of a long-term memory type.\n\nBuilt-in types include `semantic`, `episodic`, `message`, and `session_summary`.\nThe legacy `session_summary_view` name remains reserved. Search filters for either\nsummary name match both, except on stores with an existing custom `session_summary`\ntype, where each name retains its separate meaning.\nStores may also register custom memory types; this open string accepts any\nregistered type name.\n\nConstraints: 1-64 chars, must start with a letter, followed by letters, digits,\nunderscores, or dashes.\n",
                        "schema": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                            "description": "Identifier of a long-term memory type.\n\nBuilt-in types include `semantic`, `episodic`, `message`, and `session_summary`.\nThe legacy `session_summary_view` name remains reserved. Search filters for either\nsummary name match both, except on stores with an existing custom `session_summary`\ntype, where each name retains its separate meaning.\nStores may also register custom memory types; this open string accepts any\nregistered type name.\n\nConstraints: 1-64 chars, must start with a letter, followed by letters, digits,\nunderscores, or dashes."
                        }
                    },
                    {
                        "name": "includeSourceMemoryIds",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "GetSummaryViewResult 200 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetSummaryViewResultResponseContent"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "BadRequestError 400 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/BadRequestErrorResponseContent"
                                }
                            }
                        }
                    },
                    "401": {
                        "description": "AuthenticationError 401 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/AuthenticationErrorResponseContent"
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "ForbiddenError 403 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "NotFoundError 404 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/NotFoundErrorResponseContent"
                                }
                            }
                        }
                    },
                    "408": {
                        "description": "TimeoutError 408 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TimeoutErrorResponseContent"
                                }
                            }
                        }
                    },
                    "409": {
                        "description": "ConflictError 409 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ConflictErrorResponseContent"
                                }
                            }
                        }
                    },
                    "413": {
                        "description": "PayloadTooLargeError 413 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PayloadTooLargeErrorResponseContent"
                                }
                            }
                        }
                    },
                    "424": {
                        "description": "FailedDependencyError 424 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/FailedDependencyErrorResponseContent"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "TooManyRequestsError 429 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/TooManyRequestsErrorResponseContent"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "UnexpectedError 500 response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UnexpectedErrorResponseContent"
                                }
                            }
                        }
                    }
                },
                "tags": [
                    "Summary Views"
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "AddSessionEventRequestContent": {
                "type": "object",
                "description": "The event fields shared by CreateSession and AddSessionEvent.",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Required when the store selects session.append input hooks. Reuse this key only for an identical request; accepted retries reuse the saved decision and event identity."
                    },
                    "actorId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Unique actor identifier (1-255 chars). Can represent a user, agent, or any participant."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Existing namespace for the session. Like ownerId, it is taken from the first event; later values are ignored. Omit it to leave the session and its extracted memories without a namespace."
                    },
                    "role": {
                        "$ref": "#/components/schemas/MessageRole"
                    },
                    "content": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Content"
                        },
                        "description": "The message content as an array of typed content parts."
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Client-supplied timestamp for when the event happened (UTC).",
                        "format": "date-time"
                    },
                    "metadata": {
                        "description": "Optional metadata as any valid JSON value."
                    }
                },
                "required": [
                    "actorId",
                    "content",
                    "createdAt",
                    "role"
                ]
            },
            "AddSessionEventResponseContent": {
                "type": "object",
                "description": "Response returned after appending a session event.",
                "properties": {
                    "event": {
                        "$ref": "#/components/schemas/SessionEvent"
                    }
                },
                "required": [
                    "event"
                ]
            },
            "AttributeFilterClause": {
                "description": "Filter clause for a single record attribute. Exactly one member is set; the member must match the attribute's declared field type.",
                "oneOf": [
                    {
                        "type": "object",
                        "title": "string",
                        "properties": {
                            "string": {
                                "type": "string",
                                "description": "Match a string attribute equal to this value."
                            }
                        },
                        "required": [
                            "string"
                        ]
                    },
                    {
                        "type": "object",
                        "title": "number",
                        "properties": {
                            "number": {
                                "type": "number",
                                "description": "Match a numeric attribute equal to this value.",
                                "format": "double"
                            }
                        },
                        "required": [
                            "number"
                        ]
                    },
                    {
                        "type": "object",
                        "title": "boolean",
                        "properties": {
                            "boolean": {
                                "type": "boolean",
                                "description": "Match a boolean attribute equal to this value."
                            }
                        },
                        "required": [
                            "boolean"
                        ]
                    },
                    {
                        "type": "object",
                        "title": "list",
                        "properties": {
                            "list": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Match a list attribute that contains all of these values."
                            }
                        },
                        "required": [
                            "list"
                        ]
                    }
                ]
            },
            "AttributeFilterMap": {
                "type": "object",
                "additionalProperties": {
                    "$ref": "#/components/schemas/AttributeFilterClause"
                },
                "description": "Per-attribute filter clauses keyed by the custom memory type's field name."
            },
            "AttributeMap": {
                "type": "object",
                "additionalProperties": {},
                "description": "Structured record attributes: a map from the custom memory type's field name to that field's value. Values are arbitrary JSON matching the field's declared type (str, int, float, bool, list[str], list[float], or object)."
            },
            "AuthenticationErrorResponseContent": {
                "type": "object",
                "description": "Authentication credentials are missing, malformed, or invalid.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 401,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/AuthenticationErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "AuthenticationErrorType": {
                "type": "string",
                "description": "Problem type URI for authentication errors.",
                "enum": [
                    "/errors/authentication-failed"
                ]
            },
            "BadRequestErrorResponseContent": {
                "type": "object",
                "description": "Request validation or input decoding failed.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 400,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/BadRequestErrorType"
                    },
                    "errors": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/FieldError"
                        },
                        "description": "Every invalid request member found, when the failure is about members."
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "BadRequestErrorType": {
                "type": "string",
                "description": "Problem type URI for bad request errors.",
                "enum": [
                    "/errors/invalid-data",
                    "/errors/invalid-cursor",
                    "/errors/unknown-request-member",
                    "/errors/invalid-model-config",
                    "/errors/model-config-immutable",
                    "/errors/model-config-not-supported"
                ]
            },
            "BulkCreateLongTermMemoriesRequestContent": {
                "type": "object",
                "description": "Bulk create request for long-term memory records.",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Required when the memory.create input hook is selected. Optional otherwise. Reuse the same key and original request to replay its result during the retry window (at most 24 hours, capped by the store memory TTL), including writes without hooks. Reusing a key with a different request returns 409."
                    },
                    "memories": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/CreateMemoryRecord"
                        },
                        "maxItems": 100,
                        "minItems": 1,
                        "description": "List of memory records to create."
                    }
                },
                "required": [
                    "memories"
                ]
            },
            "BulkCreateLongTermMemoriesResponseContent": {
                "type": "object",
                "description": "Bulk create result for long-term memory records.",
                "properties": {
                    "created": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "description": "IDs of successfully created memory records. Always returned; empty when no records were created."
                    },
                    "errors": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/BulkOperationError"
                        },
                        "description": "Errors for memory records that failed to be created."
                    }
                },
                "required": [
                    "created"
                ]
            },
            "BulkDeleteLongTermMemoriesRequestContent": {
                "type": "object",
                "description": "Bulk delete request for long-term memory records.",
                "properties": {
                    "memoryIds": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "maxItems": 100,
                        "minItems": 1,
                        "description": "List of memory record IDs to delete (1-100 IDs)."
                    }
                },
                "required": [
                    "memoryIds"
                ]
            },
            "BulkDeleteLongTermMemoriesResponseContent": {
                "type": "object",
                "description": "Bulk delete result for long-term memory records.",
                "properties": {
                    "deleted": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "description": "IDs of successfully deleted memory records. Always returned; empty when no records were deleted."
                    },
                    "errors": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/BulkOperationError"
                        },
                        "description": "Errors for memory records that failed to be deleted."
                    }
                },
                "required": [
                    "deleted"
                ]
            },
            "BulkOperationError": {
                "type": "object",
                "description": "Error detail for a single item in a bulk operation.",
                "properties": {
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Memory record ID of the item that failed."
                    },
                    "type": {
                        "type": "string",
                        "description": "Problem type URI from the error registry, as on a whole-request error (RFC 9457)."
                    },
                    "title": {
                        "type": "string",
                        "description": "Short, human-readable summary of the problem type."
                    },
                    "status": {
                        "type": "integer",
                        "description": "The HTTP status the item would have answered on its own.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "Human-readable explanation of this item's failure."
                    }
                },
                "required": [
                    "memoryId",
                    "status",
                    "title",
                    "type"
                ]
            },
            "ConflictErrorResponseContent": {
                "type": "object",
                "description": "The request conflicts with the current state of the resource.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 409,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/ConflictErrorType"
                    },
                    "existingId": {
                        "type": "string",
                        "description": "The ID of the existing resource the request collided with, when the conflict names one."
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "ConflictErrorType": {
                "type": "string",
                "description": "Problem type URI for conflict errors.",
                "enum": [
                    "/errors/conflict",
                    "/errors/entry-not-published",
                    "/errors/entry-key-conflict",
                    "/errors/content-limit-exceeded",
                    "/errors/pinned-entry-unavailable",
                    "/errors/proposal-already-exists",
                    "/errors/proposal-evidence-conflict",
                    "/errors/proposal-evidence-capacity",
                    "/errors/proposal-trashed",
                    "/errors/proposal-open",
                    "/errors/proposal-promotion-locked",
                    "/errors/extraction-disabled",
                    "/errors/gateway-mutation-in-progress",
                    "/errors/surface-mutation-in-progress",
                    "/errors/namespace-conflict",
                    "/errors/gateway-not-empty",
                    "/errors/gateway-deleting",
                    "/errors/catalog-publication-conflict",
                    "/errors/summary-view-conflict"
                ]
            },
            "Content": {
                "description": "A single content item in a message. Exactly one member is set.",
                "oneOf": [
                    {
                        "type": "object",
                        "title": "text",
                        "properties": {
                            "text": {
                                "type": "string",
                                "description": "Text content."
                            }
                        },
                        "required": [
                            "text"
                        ]
                    }
                ]
            },
            "CreateDocumentIngestionRequestContent": {
                "type": "object",
                "properties": {
                    "documentId": {
                        "type": "string",
                        "maxLength": 512,
                        "minLength": 1,
                        "description": "Customer-controlled logical document ID. Opaque and case-sensitive."
                    },
                    "revision": {
                        "type": "string",
                        "maxLength": 512,
                        "minLength": 1,
                        "description": "Customer-controlled immutable revision token. Opaque and case-sensitive."
                    },
                    "content": {
                        "type": "string",
                        "format": "byte"
                    },
                    "mediaType": {
                        "$ref": "#/components/schemas/DocumentMediaType"
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                    },
                    "extractorId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ex_[0-9a-f]{32}$",
                        "description": "Server-generated extractor identifier: ex_ followed by 32 lowercase hex characters."
                    },
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Customer idempotency key for one document submission."
                    }
                },
                "required": [
                    "content",
                    "documentId",
                    "extractorId",
                    "idempotencyKey",
                    "mediaType",
                    "ownerId",
                    "revision"
                ]
            },
            "CreateDocumentIngestionResponseContent": {
                "type": "object",
                "properties": {
                    "ingestionId": {
                        "type": "string",
                        "maxLength": 36,
                        "minLength": 36,
                        "pattern": "^ing_[0-9a-f]{32}$",
                        "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters."
                    },
                    "status": {
                        "$ref": "#/components/schemas/DocumentIngestionStatus"
                    }
                },
                "required": [
                    "ingestionId",
                    "status"
                ]
            },
            "CreateMemoryRecord": {
                "type": "object",
                "description": "A memory record to create.",
                "properties": {
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Client-provided memory record ID. It must not already exist; change an existing memory with UpdateLongTermMemory."
                    },
                    "text": {
                        "type": "string",
                        "maxLength": 50000,
                        "minLength": 1,
                        "description": "The memory content (1-50000 chars)."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Type of memory. Built-in or a custom type registered on the store."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session ID associated with this memory (1-64 chars, alphanumeric and dashes)."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Owner ID associated with this memory."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Existing namespace resource for the memory. The destination must pass admission and is never rerouted. If it is omitted, the record is created without a namespace. Automatic routing does not place an un-namespaced record in a shared namespace."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50,
                        "description": "Topic tags for categorization (max 50 topics, each 1-100 chars)."
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    }
                },
                "required": [
                    "memoryId",
                    "ownerId",
                    "text"
                ]
            },
            "CreateNamespaceRequestContent": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z0-9_-]+$",
                        "description": "One namespace segment. Use with scope for a root or parentId for a child."
                    },
                    "path": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "A complete hierarchy path to create. Missing segments are created as needed. Mutually exclusive with name and parentId. The path does not encode scope."
                    },
                    "scope": {
                        "$ref": "#/components/schemas/NamespaceScope"
                    },
                    "parentId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Parent namespace for a direct child."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Owner for a personal root or path. Required for personal scope; omit for shared roots and children."
                    }
                }
            },
            "CreateNamespaceResponseContent": {
                "type": "object",
                "properties": {
                    "namespace": {
                        "$ref": "#/components/schemas/Namespace"
                    }
                },
                "required": [
                    "namespace"
                ]
            },
            "CreateSessionRequestContent": {
                "type": "object",
                "description": "The event fields shared by CreateSession and AddSessionEvent.",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Required when the store selects session.append input hooks. Reuse this key only for an identical request; accepted retries reuse the saved decision and event identity."
                    },
                    "actorId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Unique actor identifier (1-255 chars). Can represent a user, agent, or any participant."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Existing namespace for the session. Like ownerId, it is taken from the first event; later values are ignored. Omit it to leave the session and its extracted memories without a namespace."
                    },
                    "role": {
                        "$ref": "#/components/schemas/MessageRole"
                    },
                    "content": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Content"
                        },
                        "description": "The message content as an array of typed content parts."
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Client-supplied timestamp for when the event happened (UTC).",
                        "format": "date-time"
                    },
                    "metadata": {
                        "description": "Optional metadata as any valid JSON value."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Optional session ID. If omitted, the server generates a unique ID."
                    }
                },
                "required": [
                    "actorId",
                    "content",
                    "createdAt",
                    "role"
                ]
            },
            "CreateSessionResponseContent": {
                "type": "object",
                "description": "Response returned after appending a session event.",
                "properties": {
                    "event": {
                        "$ref": "#/components/schemas/SessionEvent"
                    }
                },
                "required": [
                    "event"
                ]
            },
            "CreateSummaryViewRequestContent": {
                "type": "object",
                "properties": {
                    "visibility": {
                        "$ref": "#/components/schemas/SummaryViewVisibility"
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "Free-text description of any API resource. May be empty."
                    },
                    "source": {
                        "$ref": "#/components/schemas/SummaryViewSource"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    }
                },
                "required": [
                    "groupBy",
                    "name",
                    "output",
                    "refreshPolicy",
                    "source"
                ]
            },
            "CreateSummaryViewResponseContent": {
                "type": "object",
                "description": "A Summary View definition. Results are separate derived state and never enter long-term-memory search.",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "description": "Immutable canonical user ID assigned by the server. Empty when ownership enforcement is disabled and the caller has no canonical user ID. Clients cannot set ownership."
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/SummaryViewVisibility"
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "Free-text description of any API resource. May be empty."
                    },
                    "source": {
                        "$ref": "#/components/schemas/SummaryViewSource"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    },
                    "definitionVersion": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "state": {
                        "$ref": "#/components/schemas/SummaryViewState"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "createdAt",
                    "definitionVersion",
                    "groupBy",
                    "name",
                    "output",
                    "ownerId",
                    "refreshPolicy",
                    "source",
                    "state",
                    "updatedAt",
                    "viewId",
                    "visibility"
                ]
            },
            "CreatedAtFilter": {
                "type": "object",
                "description": "Filter by creation timestamp.",
                "properties": {
                    "gt": {
                        "type": "string",
                        "description": "After the given timestamp.",
                        "format": "date-time"
                    },
                    "gte": {
                        "type": "string",
                        "description": "At or after the given timestamp.",
                        "format": "date-time"
                    },
                    "lt": {
                        "type": "string",
                        "description": "Before the given timestamp.",
                        "format": "date-time"
                    },
                    "lte": {
                        "type": "string",
                        "description": "At or before the given timestamp.",
                        "format": "date-time"
                    },
                    "eq": {
                        "type": "string",
                        "description": "Exactly at the given timestamp.",
                        "format": "date-time"
                    }
                }
            },
            "DeleteSummaryViewResponseContent": {
                "type": "object",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "state": {
                        "$ref": "#/components/schemas/SummaryViewState"
                    }
                },
                "required": [
                    "state",
                    "viewId"
                ]
            },
            "DocumentIngestionCleanupState": {
                "type": "string",
                "enum": [
                    "PENDING",
                    "DELETED",
                    "FAILED"
                ]
            },
            "DocumentIngestionProcessingState": {
                "type": "string",
                "enum": [
                    "QUEUED",
                    "RUNNING",
                    "SUCCEEDED",
                    "FAILED",
                    "PARTIAL"
                ]
            },
            "DocumentIngestionRecord": {
                "type": "object",
                "properties": {
                    "ingestionId": {
                        "type": "string",
                        "maxLength": 36,
                        "minLength": 36,
                        "pattern": "^ing_[0-9a-f]{32}$",
                        "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters."
                    },
                    "status": {
                        "$ref": "#/components/schemas/DocumentIngestionStatus"
                    }
                },
                "required": [
                    "ingestionId",
                    "status"
                ]
            },
            "DocumentIngestionStatus": {
                "type": "object",
                "properties": {
                    "processing": {
                        "$ref": "#/components/schemas/DocumentIngestionProcessingState"
                    },
                    "cleanup": {
                        "$ref": "#/components/schemas/DocumentIngestionCleanupState"
                    },
                    "extractorId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ex_[0-9a-f]{32}$",
                        "description": "Server-generated extractor identifier: ex_ followed by 32 lowercase hex characters."
                    },
                    "extractorRevision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Resource revision. Opaque: each change to a resource's own configuration writes a\nnew value, and a resource never gets a value it had before. Compare for equality\nonly; its format is the service's, so only its length is constrained. Returned as\n`revision`; sent back as `expectedRevision` to make a write conditional. Omitting\n`expectedRevision` makes the write unconditional."
                    },
                    "completedChunks": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "totalChunks": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "createdCount": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "filteredCount": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "error": {
                        "type": "string"
                    },
                    "retentionDeadline": {
                        "type": "number",
                        "format": "double"
                    },
                    "deletedAt": {
                        "type": "number",
                        "format": "double"
                    }
                },
                "required": [
                    "cleanup",
                    "processing"
                ]
            },
            "DocumentMediaType": {
                "type": "string",
                "enum": [
                    "text/plain",
                    "text/markdown"
                ]
            },
            "DocumentSourceIdentity": {
                "type": "object",
                "properties": {
                    "documentId": {
                        "type": "string",
                        "maxLength": 512,
                        "minLength": 1,
                        "description": "Customer-controlled logical document ID. Opaque and case-sensitive."
                    },
                    "revision": {
                        "type": "string",
                        "maxLength": 512,
                        "minLength": 1,
                        "description": "Customer-controlled immutable revision token. Opaque and case-sensitive."
                    }
                },
                "required": [
                    "documentId",
                    "revision"
                ]
            },
            "EvidenceProducer": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1
                    }
                },
                "required": [
                    "name"
                ]
            },
            "FailedDependencyErrorResponseContent": {
                "type": "object",
                "description": "A dependent resource required to process the request is unavailable or unhealthy.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 424,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/FailedDependencyErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "FailedDependencyErrorType": {
                "type": "string",
                "description": "Problem type URI for failed-dependency errors.",
                "enum": [
                    "/errors/resource-unavailable",
                    "/errors/database-out-of-memory",
                    "/errors/invalid-model-credentials",
                    "/errors/model-quota-exceeded"
                ]
            },
            "FieldError": {
                "type": "object",
                "description": "One invalid request member. A body member is named by `pointer`, a path or query parameter by `parameter`; exactly one of the two is present.",
                "properties": {
                    "pointer": {
                        "type": "string",
                        "description": "JSON Pointer (RFC 6901) to the invalid body member, such as `/vectorSpace/dimensions`."
                    },
                    "parameter": {
                        "type": "string",
                        "description": "Name of the invalid path or query parameter, such as `limit`."
                    },
                    "detail": {
                        "type": "string",
                        "description": "What is wrong with the member, in fixed words about the rule it broke, never the rejected value."
                    }
                },
                "required": [
                    "detail"
                ]
            },
            "FilterConjunction": {
                "type": "string",
                "description": "Filter conjunction mode.",
                "enum": [
                    "ALL",
                    "ANY"
                ]
            },
            "ForbiddenErrorResponseContent": {
                "type": "object",
                "description": "The caller is authenticated but not allowed to access the requested resource.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 403,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/ForbiddenErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "ForbiddenErrorType": {
                "type": "string",
                "description": "Problem type URI for authorization errors.",
                "enum": [
                    "/errors/insufficient-permissions"
                ]
            },
            "GetDocumentIngestionResponseContent": {
                "type": "object",
                "properties": {
                    "ingestion": {
                        "$ref": "#/components/schemas/DocumentIngestionRecord"
                    }
                },
                "required": [
                    "ingestion"
                ]
            },
            "GetIngestionHookStatusResponseContent": {
                "type": "object",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/IngestionHookStatus"
                    }
                },
                "required": [
                    "status"
                ]
            },
            "GetLongTermMemoryResponseContent": {
                "type": "object",
                "description": "A long-term memory record.",
                "properties": {
                    "revision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Opaque revision for conditional writes. Legacy search results can omit it; read the memory by ID before a conditional update."
                    },
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Unique memory record ID."
                    },
                    "text": {
                        "type": "string",
                        "description": "The memory content."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Type of memory. Built-in or a custom type registered on the store."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session ID associated with this memory."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Owner ID associated with this memory."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Current namespace. Absent when the record has no namespace."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50,
                        "description": "Topic tags for categorization."
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was created (UTC).",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was last updated (UTC).",
                        "format": "date-time"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemorySourceLink"
                        },
                        "description": "Generic source links for this memory. Document sources include the customer document ID and revision that produced the memory."
                    },
                    "sourcesNextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for additional source links when this response truncated attribution. Absent when every link is included."
                    },
                    "documentManaged": {
                        "type": "boolean",
                        "description": "True when this memory was created by document ingestion and is protected from generic overwrite."
                    }
                },
                "required": [
                    "createdAt",
                    "memoryId",
                    "text",
                    "updatedAt"
                ]
            },
            "GetNamespaceResponseContent": {
                "type": "object",
                "properties": {
                    "namespace": {
                        "$ref": "#/components/schemas/Namespace"
                    }
                },
                "required": [
                    "namespace"
                ]
            },
            "GetNamespaceRoutingResponseContent": {
                "type": "object",
                "properties": {
                    "policy": {
                        "$ref": "#/components/schemas/NamespaceRoutingPolicy"
                    }
                },
                "required": [
                    "policy"
                ]
            },
            "GetServiceLivenessResponseContent": {
                "type": "object",
                "description": "A service that can answer the request. Readiness failures use the shared\nHTTP 503 problem response; dependency names and errors are not public.",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/ServiceHealthStatus"
                    }
                },
                "required": [
                    "status"
                ]
            },
            "GetServiceReadinessResponseContent": {
                "type": "object",
                "description": "A service that can answer the request. Readiness failures use the shared\nHTTP 503 problem response; dependency names and errors are not public.",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/ServiceHealthStatus"
                    }
                },
                "required": [
                    "status"
                ]
            },
            "GetSessionEventResponseContent": {
                "type": "object",
                "description": "Response containing a single requested session event.",
                "properties": {
                    "event": {
                        "$ref": "#/components/schemas/SessionEvent"
                    }
                },
                "required": [
                    "event"
                ]
            },
            "GetSessionMemoryResponseContent": {
                "type": "object",
                "description": "Session memory state for a session.",
                "properties": {
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "The session ID."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "The owner of the session, set from the actorId of the first event."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Current namespace for the session, set from the first event. Absent when the session has no namespace."
                    },
                    "events": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SessionEvent"
                        },
                        "description": "Conversation events retained for this session. When summarization is enabled, events already covered by the summary are excluded unless `includeSummarisedEvents` is set; the compacted summary is returned separately in `summary`."
                    },
                    "summary": {
                        "$ref": "#/components/schemas/SessionSummary"
                    }
                },
                "required": [
                    "events",
                    "ownerId",
                    "sessionId"
                ]
            },
            "GetSummaryViewResponseContent": {
                "type": "object",
                "description": "A Summary View definition. Results are separate derived state and never enter long-term-memory search.",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "description": "Immutable canonical user ID assigned by the server. Empty when ownership enforcement is disabled and the caller has no canonical user ID. Clients cannot set ownership."
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/SummaryViewVisibility"
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "Free-text description of any API resource. May be empty."
                    },
                    "source": {
                        "$ref": "#/components/schemas/SummaryViewSource"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    },
                    "definitionVersion": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "state": {
                        "$ref": "#/components/schemas/SummaryViewState"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "createdAt",
                    "definitionVersion",
                    "groupBy",
                    "name",
                    "output",
                    "ownerId",
                    "refreshPolicy",
                    "source",
                    "state",
                    "updatedAt",
                    "viewId",
                    "visibility"
                ]
            },
            "GetSummaryViewResultResponseContent": {
                "type": "object",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "scope": {
                        "$ref": "#/components/schemas/SummaryViewScope"
                    },
                    "status": {
                        "$ref": "#/components/schemas/SummaryViewResultStatus"
                    },
                    "stale": {
                        "type": "boolean"
                    },
                    "format": {
                        "$ref": "#/components/schemas/SummaryViewOutputFormat"
                    },
                    "value": {
                        "$ref": "#/components/schemas/SummaryViewResultValue"
                    },
                    "sourceMemoryCount": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Number of matching source memories. When selection stops early, a separate count query measures the matching total without reading the remaining source pages. Concurrent writes can change the source set between queries; the count is never less than the number of records already observed.",
                        "format": "int64"
                    },
                    "summarizedMemoryCount": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Number of matching source memories included in the generated value after bounded deterministic selection.",
                        "format": "int64"
                    },
                    "truncated": {
                        "type": "boolean",
                        "description": "Combined signal for sourcesOmitted or sourceContentTruncated."
                    },
                    "sourcesOmitted": {
                        "type": "boolean",
                        "description": "True when matching source memories were excluded from generation, including when further source pages were not read after reaching an input budget."
                    },
                    "sourceContentTruncated": {
                        "type": "boolean",
                        "description": "True when content from an included source memory was clipped to fit a source or generation input budget. This can be true even when sourceMemoryCount equals summarizedMemoryCount."
                    },
                    "sourceMemoryIds": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "description": "The memory IDs selected for the materialized value. Included only when requested with includeSourceMemoryIds=true."
                    },
                    "sourceUpdatedAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "computedAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "definitionVersion": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "errorCode": {
                        "$ref": "#/components/schemas/SummaryViewResultErrorCode"
                    }
                },
                "required": [
                    "definitionVersion",
                    "format",
                    "scope",
                    "sourceContentTruncated",
                    "sourceMemoryCount",
                    "sourcesOmitted",
                    "stale",
                    "status",
                    "summarizedMemoryCount",
                    "truncated",
                    "viewId"
                ]
            },
            "HookStatusSource": {
                "type": "object",
                "additionalProperties": {
                    "type": "string"
                }
            },
            "IngestionHookRetryErrorResponseContent": {
                "type": "object",
                "description": "A saved ingestion hook decision is waiting for its next bounded attempt.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 503,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/IngestionHookRetryErrorType"
                    },
                    "retryAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "retryAt",
                    "status",
                    "title",
                    "type"
                ]
            },
            "IngestionHookRetryErrorType": {
                "type": "string",
                "enum": [
                    "/errors/ingestion-hook-retry"
                ]
            },
            "IngestionHookStatus": {
                "type": "object",
                "description": "Compact hook metadata, retained for seven days after completion or expiry. Application state is independent of the decision state; earlier writes may have completed before a later failure.",
                "properties": {
                    "eventId": {
                        "type": "string"
                    },
                    "ingestionOperationId": {
                        "type": "string"
                    },
                    "phase": {
                        "type": "string"
                    },
                    "path": {
                        "type": "string"
                    },
                    "ownerId": {
                        "type": "string"
                    },
                    "source": {
                        "$ref": "#/components/schemas/HookStatusSource"
                    },
                    "configRevision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Resource revision. Opaque: each change to a resource's own configuration writes a\nnew value, and a resource never gets a value it had before. Compare for equality\nonly; its format is the service's, so only its length is constrained. Returned as\n`revision`; sent back as `expectedRevision` to make a write conditional. Omitting\n`expectedRevision` makes the write unconditional."
                    },
                    "state": {
                        "type": "string"
                    },
                    "applyState": {
                        "type": "string"
                    },
                    "attempts": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "deadline": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "nextAttemptAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "lastError": {
                        "type": "string"
                    },
                    "applied": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "filtered": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "conflicts": {
                        "type": "integer",
                        "format": "int32"
                    }
                },
                "required": [
                    "applied",
                    "applyState",
                    "attempts",
                    "configRevision",
                    "conflicts",
                    "createdAt",
                    "deadline",
                    "eventId",
                    "filtered",
                    "ingestionOperationId",
                    "ownerId",
                    "path",
                    "phase",
                    "source",
                    "state",
                    "updatedAt"
                ]
            },
            "IngestionHookStoppedErrorResponseContent": {
                "type": "object",
                "description": "The ingestion hook stopped this operation without applying unapproved content.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 422,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/IngestionHookStoppedErrorType"
                    },
                    "state": {
                        "$ref": "#/components/schemas/IngestionHookStoppedState"
                    }
                },
                "required": [
                    "state",
                    "status",
                    "title",
                    "type"
                ]
            },
            "IngestionHookStoppedErrorType": {
                "type": "string",
                "enum": [
                    "/errors/ingestion-hook-stopped"
                ]
            },
            "IngestionHookStoppedState": {
                "type": "string",
                "enum": [
                    "REJECTED",
                    "FAILED",
                    "EXPIRED",
                    "CANCELLED",
                    "CONFLICT"
                ]
            },
            "ListDocumentIngestionOutputsResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListIngestionHookStatusesResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/IngestionHookStatus"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListMemorySourceEvidenceResponseContent": {
                "type": "object",
                "properties": {
                    "source": {
                        "$ref": "#/components/schemas/MemorySourceLink"
                    }
                },
                "required": [
                    "source"
                ]
            },
            "ListMemorySourceLinksResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemorySourceLink"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListNamespacesResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Namespace"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for fetching the next page. Omitted when no more results."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListSessionsResponseContent": {
                "type": "object",
                "description": "Paginated session rows for a store.",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SessionListItem"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListSourceMemoriesResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemoryRecord"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ListSummaryViewsResponseContent": {
                "type": "object",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryView"
                        }
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque position in a list, returned as `nextCursor` and passed back as `cursor`."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "LlmPromptSpec": {
                "type": "object",
                "description": "Customer-authored prompt evaluated by the LLM routing strategy.",
                "properties": {
                    "prompt": {
                        "type": "string",
                        "maxLength": 2000,
                        "minLength": 1
                    }
                },
                "required": [
                    "prompt"
                ]
            },
            "LongTermMemoryFilter": {
                "type": "object",
                "description": "Grouping of filter conditions for long-term memory search.",
                "properties": {
                    "op": {
                        "$ref": "#/components/schemas/FilterConjunction"
                    },
                    "sessionId": {
                        "$ref": "#/components/schemas/SessionIdFilter"
                    },
                    "ownerId": {
                        "$ref": "#/components/schemas/OwnerIdFilter"
                    },
                    "namespaceId": {
                        "$ref": "#/components/schemas/NamespaceIdFilter"
                    },
                    "unnamespaced": {
                        "type": "boolean",
                        "description": "When true, matches only records that have no namespace. This scope is always combined with every other filter condition. Do not supply namespaceId with this field."
                    },
                    "topics": {
                        "$ref": "#/components/schemas/TopicsFilter"
                    },
                    "memoryType": {
                        "$ref": "#/components/schemas/MemoryTypeFilter"
                    },
                    "createdAt": {
                        "$ref": "#/components/schemas/CreatedAtFilter"
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeFilterMap"
                    }
                }
            },
            "LongTermMemorySearchSortBy": {
                "type": "string",
                "description": "Timestamp field used to order long-term memory search results.",
                "enum": [
                    "createdAt",
                    "updatedAt"
                ]
            },
            "LongTermMemorySearchSortOrder": {
                "type": "string",
                "description": "Direction used to order long-term memory search results.",
                "enum": [
                    "ASC",
                    "DESC"
                ]
            },
            "MatcherKind": {
                "type": "string",
                "description": "The matching techniques this API supports.",
                "enum": [
                    "REGEX"
                ]
            },
            "MatcherSpec": {
                "type": "object",
                "description": "How a detector matches, as a tagged union of techniques.\n\nExactly the block naming the declared kind must be present; a block belonging to\nany other kind is rejected rather than guessed at. New kinds may be added.",
                "properties": {
                    "kind": {
                        "$ref": "#/components/schemas/MatcherKind"
                    },
                    "regex": {
                        "$ref": "#/components/schemas/RegexSpec"
                    }
                },
                "required": [
                    "kind"
                ]
            },
            "MemoryRecord": {
                "type": "object",
                "description": "A long-term memory record.",
                "properties": {
                    "revision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Opaque revision for conditional writes. Legacy search results can omit it; read the memory by ID before a conditional update."
                    },
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Unique memory record ID."
                    },
                    "text": {
                        "type": "string",
                        "description": "The memory content."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Type of memory. Built-in or a custom type registered on the store."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session ID associated with this memory."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Owner ID associated with this memory."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Current namespace. Absent when the record has no namespace."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50,
                        "description": "Topic tags for categorization."
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was created (UTC).",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was last updated (UTC).",
                        "format": "date-time"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemorySourceLink"
                        },
                        "description": "Generic source links for this memory. Document sources include the customer document ID and revision that produced the memory."
                    },
                    "sourcesNextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for additional source links when this response truncated attribution. Absent when every link is included."
                    },
                    "documentManaged": {
                        "type": "boolean",
                        "description": "True when this memory was created by document ingestion and is protected from generic overwrite."
                    }
                },
                "required": [
                    "createdAt",
                    "memoryId",
                    "text",
                    "updatedAt"
                ]
            },
            "MemorySourceEvidence": {
                "type": "object",
                "properties": {
                    "evidenceId": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Identity of a logical extraction occurrence. Delivery retries retain this ID; a new extraction receives a new ID. Absent on legacy evidence."
                    },
                    "schemaVersion": {
                        "type": "integer",
                        "description": "Version of the evidence metadata contract, currently 1. Absent on legacy evidence.",
                        "format": "int32"
                    },
                    "capturedAt": {
                        "type": "string",
                        "description": "UTC time when the producer prepared the input for extraction, before model invocation. This is not the source event time.",
                        "format": "date-time"
                    },
                    "producer": {
                        "$ref": "#/components/schemas/EvidenceProducer"
                    },
                    "ingestionId": {
                        "type": "string",
                        "maxLength": 36,
                        "minLength": 36,
                        "pattern": "^ing_[0-9a-f]{32}$",
                        "description": "Server-generated document ingestion identifier: ing_ followed by 32 lowercase hex characters."
                    },
                    "chunkId": {
                        "type": "string"
                    },
                    "start": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "end": {
                        "type": "integer",
                        "format": "int32"
                    }
                },
                "required": [
                    "chunkId",
                    "ingestionId"
                ]
            },
            "MemorySourceKind": {
                "type": "string",
                "enum": [
                    "DOCUMENT",
                    "SESSION"
                ]
            },
            "MemorySourceLink": {
                "type": "object",
                "properties": {
                    "sourceId": {
                        "type": "string"
                    },
                    "kind": {
                        "$ref": "#/components/schemas/MemorySourceKind"
                    },
                    "identity": {
                        "$ref": "#/components/schemas/DocumentSourceIdentity"
                    },
                    "session": {
                        "$ref": "#/components/schemas/SessionSourceIdentity"
                    },
                    "evidence": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemorySourceEvidence"
                        }
                    },
                    "sessionEvidence": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SessionSourceEvidence"
                        }
                    },
                    "evidenceNextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for GET /iris/data/v1/agent-memory/stores/{storeId}/memories/{memoryId}/sources/{sourceId}/evidence. Continues evidence or sessionEvidence for this source; absent when every item is included."
                    }
                },
                "required": [
                    "kind",
                    "sourceId"
                ]
            },
            "MemoryTypeFilter": {
                "type": "object",
                "description": "Filter by memory type. Matching is case-insensitive.",
                "properties": {
                    "eq": {
                        "type": "string",
                        "description": "Equals the given value."
                    },
                    "ne": {
                        "type": "string",
                        "description": "Not equal to the given value."
                    },
                    "in": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Matches any of the given values."
                    },
                    "all": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Matches all of the given values."
                    }
                }
            },
            "MessageRole": {
                "type": "string",
                "description": "Message role for session events.",
                "enum": [
                    "USER",
                    "ASSISTANT",
                    "SYSTEM"
                ]
            },
            "MoveLongTermMemoriesRequestContent": {
                "type": "object",
                "properties": {
                    "memoryIds": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        },
                        "maxItems": 100,
                        "minItems": 1
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Existing namespace resource that receives the memories. Omit it to automatically route memories already in a shared namespace when automatic routing and the store's routing policy are enabled. Personal and un-namespaced memories keep their placement and receive a per-item error. If routing is disabled or no destination qualifies, the memory also keeps its placement and receives a per-item error."
                    }
                },
                "required": [
                    "memoryIds"
                ]
            },
            "MoveLongTermMemoriesResponseContent": {
                "type": "object",
                "properties": {
                    "moved": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                        }
                    },
                    "errors": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/BulkOperationError"
                        }
                    }
                },
                "required": [
                    "moved"
                ]
            },
            "MutableSummaryViewState": {
                "type": "string",
                "description": "States a caller may set directly. Deleting is entered only by the delete operation.",
                "enum": [
                    "ACTIVE",
                    "DISABLED"
                ]
            },
            "Namespace": {
                "type": "object",
                "description": "A namespace hierarchy record.",
                "properties": {
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z0-9_-]+$",
                        "description": "One case-sensitive namespace path segment."
                    },
                    "parentId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "rootId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "An application-user ID selected by the platform for a namespace root. It follows the same rules as ActorId."
                    },
                    "scope": {
                        "$ref": "#/components/schemas/NamespaceScope"
                    },
                    "state": {
                        "$ref": "#/components/schemas/NamespaceState"
                    },
                    "revision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Resource revision. Opaque: each change to a resource's own configuration writes a\nnew value, and a resource never gets a value it had before. Compare for equality\nonly; its format is the service's, so only its length is constrained. Returned as\n`revision`; sent back as `expectedRevision` to make a write conditional. Omitting\n`expectedRevision` makes the write unconditional."
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "path": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Current case-sensitive path, derived from the live hierarchy."
                    }
                },
                "required": [
                    "createdAt",
                    "name",
                    "namespaceId",
                    "path",
                    "revision",
                    "rootId",
                    "scope",
                    "state",
                    "updatedAt"
                ]
            },
            "NamespaceIdFilter": {
                "type": "object",
                "description": "Filter by stable namespace resource identifier. Supports exact or any-of matching.",
                "properties": {
                    "eq": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Equals the given value."
                    },
                    "in": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 35,
                            "minLength": 35,
                            "pattern": "^ns_[0-9a-f]{32}$",
                            "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                        },
                        "description": "Matches any of the given values."
                    }
                }
            },
            "NamespaceRoutingPolicy": {
                "type": "object",
                "description": "Store-level automatic namespace routing and admission policy. Global rules target shared namespaces only. Accept rules select candidates in list order. All enabled reject rules for a destination apply regardless of their position or how the destination was selected.",
                "properties": {
                    "enabled": {
                        "type": "boolean"
                    },
                    "rules": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/NamespaceRoutingRule"
                        },
                        "maxItems": 32
                    }
                },
                "required": [
                    "enabled"
                ]
            },
            "NamespaceRoutingRule": {
                "type": "object",
                "description": "One routing or admission rule. action is accept or reject. Strategies run in list order and the first match fires the rule. An accept with no strategies always matches; a reject with no strategies never matches. A matching accept selects a candidate. Every enabled reject for that destination must pass before placement. A veto skips that candidate during automatic routing and fails explicit placement.",
                "properties": {
                    "id": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Routing rule identifier (1-64 chars)."
                    },
                    "destinationNamespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "enabled": {
                        "type": "boolean"
                    },
                    "action": {
                        "$ref": "#/components/schemas/RoutingRuleAction"
                    },
                    "strategies": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/RouteCondition"
                        },
                        "maxItems": 8
                    }
                },
                "required": [
                    "action",
                    "destinationNamespaceId",
                    "enabled",
                    "id"
                ]
            },
            "NamespaceScope": {
                "type": "string",
                "description": "The root scope of a namespace hierarchy.",
                "enum": [
                    "PERSONAL",
                    "SHARED"
                ]
            },
            "NamespaceSortBy": {
                "type": "string",
                "enum": [
                    "id",
                    "name",
                    "createdAt",
                    "updatedAt"
                ]
            },
            "NamespaceSortOrder": {
                "type": "string",
                "enum": [
                    "ASC",
                    "DESC"
                ]
            },
            "NamespaceState": {
                "type": "string",
                "description": "Whether a namespace accepts new children and placements.",
                "enum": [
                    "ACTIVE",
                    "ARCHIVED"
                ]
            },
            "NamespaceUpdateState": {
                "type": "string",
                "description": "The archive-only state transition accepted by UpdateNamespace.",
                "enum": [
                    "ARCHIVED"
                ]
            },
            "NotFoundErrorResponseContent": {
                "type": "object",
                "description": "The requested resource does not exist.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 404,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/NotFoundErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "NotFoundErrorType": {
                "type": "string",
                "description": "Problem type URI for not-found errors.",
                "enum": [
                    "/errors/resource-not-found",
                    "/errors/gateway-not-found",
                    "/errors/upstream-not-found"
                ]
            },
            "OwnerIdFilter": {
                "type": "object",
                "description": "Filter by the long-term memory ownerId field. Matching is case-sensitive.",
                "properties": {
                    "eq": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Equals the given value."
                    },
                    "ne": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Not equal to the given value."
                    },
                    "in": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                        },
                        "description": "Matches any of the given values."
                    },
                    "all": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                            "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                        },
                        "description": "Matches all of the given values."
                    }
                }
            },
            "PayloadTooLargeErrorResponseContent": {
                "type": "object",
                "description": "The request payload exceeds the maximum supported size.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 413,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/PayloadTooLargeErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "PayloadTooLargeErrorType": {
                "type": "string",
                "description": "Problem type URI for payload-too-large errors.",
                "enum": [
                    "/errors/payload-too-large"
                ]
            },
            "PreconditionFailedErrorResponseContent": {
                "type": "object",
                "description": "The write named an expected revision (expectedRevision or If-Match) that is no longer current. Read the resource again and retry.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 412,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/PreconditionFailedErrorType"
                    },
                    "currentRevision": {
                        "type": "string",
                        "description": "The resource's current revision, when the service reports it. Read the resource again before retrying; do not send this value back without reading."
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "PreconditionFailedErrorType": {
                "type": "string",
                "description": "Problem type URI for a write whose expected revision is no longer current. A write guarded by an If-Match header on an HTTP entity tag uses a different type; see the Identity Service API.",
                "enum": [
                    "/errors/revision-conflict"
                ]
            },
            "PutNamespaceRoutingRequestContent": {
                "type": "object",
                "properties": {
                    "policy": {
                        "$ref": "#/components/schemas/NamespaceRoutingPolicy"
                    }
                },
                "required": [
                    "policy"
                ]
            },
            "PutNamespaceRoutingResponseContent": {
                "type": "object",
                "properties": {
                    "policy": {
                        "$ref": "#/components/schemas/NamespaceRoutingPolicy"
                    }
                },
                "required": [
                    "policy"
                ]
            },
            "RefreshSummaryViewRequestContent": {
                "type": "object",
                "properties": {
                    "target": {
                        "$ref": "#/components/schemas/SummaryViewRefreshTarget"
                    },
                    "scope": {
                        "$ref": "#/components/schemas/SummaryViewScope"
                    }
                },
                "required": [
                    "target"
                ]
            },
            "RefreshSummaryViewResponseContent": {
                "type": "object",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "target": {
                        "$ref": "#/components/schemas/SummaryViewRefreshTarget"
                    },
                    "accepted": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "accepted",
                    "target",
                    "viewId"
                ]
            },
            "RegexSpec": {
                "type": "object",
                "description": "A regular expression to match against.\n\nEvaluated by RE2, which runs in linear time \u2014 so an expensive pattern is not a\ndenial-of-service risk, but lookaround and backreferences are unavailable.\nRejected on write if it does not compile, or if it can match without consuming\ntext: such a pattern matches at every position, so it would exclude every memory\nthe store writes.",
                "properties": {
                    "pattern": {
                        "type": "string",
                        "maxLength": 512,
                        "minLength": 1,
                        "description": "The pattern, in RE2 syntax."
                    }
                },
                "required": [
                    "pattern"
                ]
            },
            "ResourceSuspendedErrorResponseContent": {
                "type": "object",
                "description": "The requested resource exists but is suspended by an administrator.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 423,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/ResourceSuspendedErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "ResourceSuspendedErrorType": {
                "type": "string",
                "description": "Problem type URI for suspended resources.",
                "enum": [
                    "/errors/resource-suspended"
                ]
            },
            "RouteCondition": {
                "type": "object",
                "description": "One plug-in strategy invocation. Exactly the block naming the declared kind must be present. List order is evaluation order.",
                "properties": {
                    "kind": {
                        "$ref": "#/components/schemas/RouteStrategyKind"
                    },
                    "llmPrompt": {
                        "$ref": "#/components/schemas/LlmPromptSpec"
                    },
                    "matcher": {
                        "$ref": "#/components/schemas/MatcherSpec"
                    }
                },
                "required": [
                    "kind"
                ]
            },
            "RouteStrategyKind": {
                "type": "string",
                "description": "Routing strategy kinds. Unknown kinds are rejected.",
                "enum": [
                    "LLM_PROMPT",
                    "MATCHER_SPEC"
                ]
            },
            "RoutingRuleAction": {
                "type": "string",
                "description": "Whether the rule accepts into the destination or rejects that destination.",
                "enum": [
                    "ACCEPT",
                    "REJECT"
                ]
            },
            "SearchLongTermMemoryRequestContent": {
                "type": "object",
                "description": "Semantic search request for long-term memory records.",
                "properties": {
                    "query": {
                        "type": "string",
                        "description": "Text to use for semantic search."
                    },
                    "minScore": {
                        "type": "number",
                        "maximum": 1,
                        "minimum": 0,
                        "description": "The minimum score for vector search results: (2 - cosine distance) / 2. Allowed range: 0-1.",
                        "format": "double"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "excludeDocumentManaged": {
                        "type": "boolean",
                        "description": "When true, omit document-managed memories from results."
                    },
                    "sortBy": {
                        "$ref": "#/components/schemas/LongTermMemorySearchSortBy"
                    },
                    "sortOrder": {
                        "$ref": "#/components/schemas/LongTermMemorySearchSortOrder"
                    },
                    "limit": {
                        "type": "integer",
                        "default": 50,
                        "maximum": 100,
                        "minimum": 1,
                        "description": "Maximum number of results to return. Defaults to 50. Allowed range: 1-100.",
                        "format": "int32"
                    },
                    "cursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token from a previous response for the next page."
                    }
                }
            },
            "SearchLongTermMemoryResponseContent": {
                "type": "object",
                "description": "Semantic search result for long-term memory records.",
                "properties": {
                    "items": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemoryRecord"
                        },
                        "description": "List of matching memory records. Always returned; empty when no records match."
                    },
                    "nextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for fetching the next page. Omitted when no more results."
                    }
                },
                "required": [
                    "items"
                ]
            },
            "ServiceHealthStatus": {
                "type": "string",
                "enum": [
                    "UP"
                ]
            },
            "ServiceUnavailableErrorResponseContent": {
                "type": "object",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 503,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/ServiceUnavailableErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "ServiceUnavailableErrorType": {
                "type": "string",
                "enum": [
                    "/errors/service-unavailable",
                    "/errors/playbook-not-ready",
                    "/errors/resource-unavailable"
                ]
            },
            "SessionEvent": {
                "type": "object",
                "description": "A single event in the session history.",
                "properties": {
                    "eventId": {
                        "type": "string",
                        "maxLength": 36,
                        "minLength": 36,
                        "pattern": "^evt_[0-9a-f]{32}$",
                        "description": "Auto-generated event ID."
                    },
                    "actorId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Unique actor identifier (1-255 chars). Can represent a user, agent, or any participant."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session identifier (client-provided or server-generated)."
                    },
                    "role": {
                        "$ref": "#/components/schemas/MessageRole"
                    },
                    "content": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Content"
                        },
                        "description": "The message content as an array of typed content parts."
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Client-supplied timestamp for when the event happened (UTC).",
                        "format": "date-time"
                    },
                    "systemTimestamp": {
                        "type": "string",
                        "description": "Server-set timestamp for when the dataplane ingested the event (UTC).",
                        "format": "date-time"
                    },
                    "metadata": {
                        "description": "Optional metadata as any valid JSON value."
                    }
                },
                "required": [
                    "actorId",
                    "content",
                    "createdAt",
                    "eventId",
                    "role",
                    "sessionId",
                    "systemTimestamp"
                ]
            },
            "SessionIdFilter": {
                "type": "object",
                "description": "Filter by the long-term memory sessionId field. Matching is case-sensitive.",
                "properties": {
                    "eq": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Equals the given value."
                    },
                    "ne": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Not equal to the given value."
                    },
                    "in": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                        },
                        "description": "Matches any of the given values."
                    },
                    "all": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 64,
                            "minLength": 1,
                            "pattern": "^[A-Za-z0-9_-]+$",
                            "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                        },
                        "description": "Matches all of the given values."
                    }
                }
            },
            "SessionListItem": {
                "type": "object",
                "description": "One session row without events or summary text. Owner ID and timestamps are absent when unknown on legacy sessions.",
                "properties": {
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "The owner of the session, set from the actorId of the first event. Absent for a legacy session that has no recorded owner."
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    }
                },
                "required": [
                    "sessionId"
                ]
            },
            "SessionListSortBy": {
                "type": "string",
                "enum": [
                    "sessionId",
                    "createdAt",
                    "updatedAt"
                ]
            },
            "SessionListSortOrder": {
                "type": "string",
                "enum": [
                    "ASC",
                    "DESC"
                ]
            },
            "SessionSourceEvidence": {
                "type": "object",
                "properties": {
                    "evidenceId": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Identity of a logical extraction occurrence. Delivery retries retain this ID; a new extraction receives a new ID. Absent on legacy evidence."
                    },
                    "schemaVersion": {
                        "type": "integer",
                        "description": "Version of the evidence metadata contract, currently 1. Absent on legacy evidence.",
                        "format": "int32"
                    },
                    "capturedAt": {
                        "type": "string",
                        "description": "UTC time when the producer prepared the input for extraction, before model invocation. This is not the source event time.",
                        "format": "date-time"
                    },
                    "producer": {
                        "$ref": "#/components/schemas/EvidenceProducer"
                    },
                    "eventIds": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 36,
                            "minLength": 36,
                            "pattern": "^evt_[0-9a-f]{32}$",
                            "description": "Server-generated event identifier: evt_ followed by 32 lowercase hex characters."
                        },
                        "description": "Ordered IDs of events whose content was supplied to one model request. Input attribution, not fact citations."
                    }
                },
                "required": [
                    "eventIds"
                ]
            },
            "SessionSourceIdentity": {
                "type": "object",
                "properties": {
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                    }
                },
                "required": [
                    "ownerId",
                    "sessionId"
                ]
            },
            "SessionSummary": {
                "type": "object",
                "description": "Compacted summary of older session history for a session.\n\nThis is derived session state maintained by the background summarization workflow, not a conversation event. It is present only after at least one summarization cycle has completed.",
                "properties": {
                    "text": {
                        "type": "string",
                        "description": "The summary text, a single coherent block."
                    },
                    "summarizedUpToEventId": {
                        "type": "string",
                        "maxLength": 36,
                        "minLength": 36,
                        "pattern": "^evt_[0-9a-f]{32}$",
                        "description": "Boundary event ID. This event and all events before it (by array position) are covered by the summary; `events` contains the retained turns after this boundary."
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Timestamp when the summary was first created (UTC). Preserved across re-summarization cycles.",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "description": "Timestamp when the summary was last regenerated (UTC). Updated on every summarization cycle. Equal to createdAt on the first cycle.",
                        "format": "date-time"
                    },
                    "metadata": {
                        "description": "Metadata as a JSON object (e.g., model name, token count). Always present; defaults to an empty object when no metadata was supplied."
                    },
                    "summarizedEvents": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "Cumulative number of session events folded into this summary across all summarization cycles. Always positive. A value of 1 may indicate a summary created before this field was tracked; it self-corrects to a real count on the next summarization cycle.",
                        "format": "int64"
                    }
                },
                "required": [
                    "createdAt",
                    "metadata",
                    "summarizedEvents",
                    "summarizedUpToEventId",
                    "text",
                    "updatedAt"
                ]
            },
            "StoreHealthFeature": {
                "type": "object",
                "description": "Feature-level store health.",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/StoreHealthStatus"
                    }
                },
                "required": [
                    "status"
                ]
            },
            "StoreHealthFeatureMap": {
                "type": "object",
                "additionalProperties": {
                    "$ref": "#/components/schemas/StoreHealthFeature"
                }
            },
            "StoreHealthResponseContent": {
                "type": "object",
                "description": "Store-scoped Agent Memory feature health.",
                "properties": {
                    "status": {
                        "$ref": "#/components/schemas/StoreHealthStatus"
                    },
                    "features": {
                        "$ref": "#/components/schemas/StoreHealthFeatureMap"
                    }
                },
                "required": [
                    "features",
                    "status"
                ]
            },
            "StoreHealthStatus": {
                "type": "string",
                "description": "Store health status.",
                "enum": [
                    "HEALTHY",
                    "DEGRADED",
                    "UNAVAILABLE"
                ]
            },
            "SummaryView": {
                "type": "object",
                "description": "A Summary View definition. Results are separate derived state and never enter long-term-memory search.",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "description": "Immutable canonical user ID assigned by the server. Empty when ownership enforcement is disabled and the caller has no canonical user ID. Clients cannot set ownership."
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/SummaryViewVisibility"
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "Free-text description of any API resource. May be empty."
                    },
                    "source": {
                        "$ref": "#/components/schemas/SummaryViewSource"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    },
                    "definitionVersion": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "state": {
                        "$ref": "#/components/schemas/SummaryViewState"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "createdAt",
                    "definitionVersion",
                    "groupBy",
                    "name",
                    "output",
                    "ownerId",
                    "refreshPolicy",
                    "source",
                    "state",
                    "updatedAt",
                    "viewId",
                    "visibility"
                ]
            },
            "SummaryViewEvictionPolicy": {
                "type": "object",
                "description": "Selects the bounded set of grouped results. Matching long-term-memory mutations make a scope recent.",
                "properties": {
                    "maxPartitions": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int32"
                    }
                },
                "required": [
                    "maxPartitions"
                ]
            },
            "SummaryViewField": {
                "type": "object",
                "description": "A field in a bounded structured Summary View result. All fields are optional in generated results.",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$"
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 200,
                        "minLength": 1
                    },
                    "type": {
                        "$ref": "#/components/schemas/SummaryViewFieldType"
                    }
                },
                "required": [
                    "description",
                    "name",
                    "type"
                ]
            },
            "SummaryViewFieldType": {
                "type": "string",
                "description": "Supported structured-output field types. This matches the custom-memory field vocabulary.",
                "enum": [
                    "STRING",
                    "INTEGER",
                    "FLOAT",
                    "BOOLEAN",
                    "STRING_LIST",
                    "FLOAT_LIST",
                    "OBJECT"
                ]
            },
            "SummaryViewGroupField": {
                "type": "string",
                "description": "A deterministic source field used to partition a Summary View.",
                "enum": [
                    "ownerId",
                    "sessionId",
                    "namespaceId",
                    "memoryType"
                ]
            },
            "SummaryViewOutputConfig": {
                "type": "object",
                "description": "Text or structured generation configuration. Schema is required exactly when format is structured.",
                "properties": {
                    "format": {
                        "$ref": "#/components/schemas/SummaryViewOutputFormat"
                    },
                    "instructions": {
                        "type": "string",
                        "maxLength": 10000,
                        "description": "Customer-authored generation instructions. Prompt-security validation is enforced by the service."
                    },
                    "schema": {
                        "$ref": "#/components/schemas/SummaryViewSchema"
                    }
                },
                "required": [
                    "format"
                ]
            },
            "SummaryViewOutputFormat": {
                "type": "string",
                "description": "Summary View output format.",
                "enum": [
                    "TEXT",
                    "STRUCTURED"
                ]
            },
            "SummaryViewQuotaCode": {
                "type": "string",
                "description": "Stable machine-readable Summary View quota code.",
                "enum": [
                    "DEFINITION_LIMIT_EXCEEDED",
                    "PARTITION_LIMIT_EXCEEDED",
                    "SOURCE_LIMIT_EXCEEDED",
                    "SCHEDULED_GENERATION_LIMIT_EXCEEDED",
                    "CONCURRENCY_LIMIT_EXCEEDED"
                ]
            },
            "SummaryViewQuotaErrorResponseContent": {
                "type": "object",
                "description": "A Summary View operation exceeded an enabled store quota. Exact limits depend on the deployment.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 429,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/SummaryViewQuotaErrorType"
                    },
                    "code": {
                        "$ref": "#/components/schemas/SummaryViewQuotaCode"
                    }
                },
                "required": [
                    "code",
                    "status",
                    "title",
                    "type"
                ]
            },
            "SummaryViewQuotaErrorType": {
                "type": "string",
                "description": "Problem type URI for Summary View quota errors.",
                "enum": [
                    "/errors/summary-view-quota-exceeded"
                ]
            },
            "SummaryViewRefreshMode": {
                "type": "string",
                "description": "Summary View refresh mode.",
                "enum": [
                    "MANUAL",
                    "CONTINUOUS"
                ]
            },
            "SummaryViewRefreshPolicy": {
                "type": "object",
                "description": "Refresh policy. Continuous views require reconcileIntervalSeconds; manual views omit both interval fields.",
                "properties": {
                    "mode": {
                        "$ref": "#/components/schemas/SummaryViewRefreshMode"
                    },
                    "debounceSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int32"
                    },
                    "reconcileIntervalSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int32"
                    }
                },
                "required": [
                    "mode"
                ]
            },
            "SummaryViewRefreshTarget": {
                "type": "string",
                "description": "Manual refresh target. Partition refreshes require an exact configured scope; full refreshes reconcile every current and prior partition.",
                "enum": [
                    "PARTITION",
                    "FULL"
                ]
            },
            "SummaryViewResultErrorCode": {
                "type": "string",
                "description": "Customer-safe refresh failure code. Provider details and source content are never returned.",
                "enum": [
                    "SOURCE_LIMIT_EXCEEDED",
                    "GENERATION_FAILED",
                    "OUTPUT_VALIDATION_FAILED",
                    "REFRESH_RETRIES_EXHAUSTED",
                    "INTERNAL_ERROR"
                ]
            },
            "SummaryViewResultStatus": {
                "type": "string",
                "description": "Materialization refresh state.",
                "enum": [
                    "COLD",
                    "PENDING",
                    "READY",
                    "EMPTY",
                    "REFRESHING",
                    "FAILED"
                ]
            },
            "SummaryViewResultValue": {
                "description": "Exactly one generated result value. It is omitted for cold, pending, and empty results, and may be omitted for failed results with no last good value.",
                "oneOf": [
                    {
                        "type": "object",
                        "title": "text",
                        "properties": {
                            "text": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "text"
                        ]
                    },
                    {
                        "type": "object",
                        "title": "data",
                        "properties": {
                            "data": {}
                        },
                        "required": [
                            "data"
                        ]
                    }
                ]
            },
            "SummaryViewSchema": {
                "type": "object",
                "description": "Bounded structured-output schema. Nested object schemas, required fields, and arbitrary JSON Schema are not supported.",
                "properties": {
                    "fields": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewField"
                        },
                        "maxItems": 50,
                        "minItems": 1
                    }
                },
                "required": [
                    "fields"
                ]
            },
            "SummaryViewScope": {
                "type": "object",
                "description": "An exact partition scope. The service requires exactly the fields configured by groupBy; singleton views accept none.",
                "properties": {
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Identifier of a long-term memory type.\n\nBuilt-in types include `semantic`, `episodic`, `message`, and `session_summary`.\nThe legacy `session_summary_view` name remains reserved. Search filters for either\nsummary name match both, except on stores with an existing custom `session_summary`\ntype, where each name retains its separate meaning.\nStores may also register custom memory types; this open string accepts any\nregistered type name.\n\nConstraints: 1-64 chars, must start with a letter, followed by letters, digits,\nunderscores, or dashes."
                    }
                }
            },
            "SummaryViewSource": {
                "type": "string",
                "description": "The source record family summarized by a Summary View. Only long-term memory is supported.",
                "enum": [
                    "LONG_TERM"
                ]
            },
            "SummaryViewState": {
                "type": "string",
                "description": "Summary View definition lifecycle state.",
                "enum": [
                    "ACTIVE",
                    "DISABLED",
                    "DELETING"
                ]
            },
            "SummaryViewVisibility": {
                "type": "string",
                "description": "The immutable audience of a Summary View.",
                "enum": [
                    "PRIVATE",
                    "SHARED"
                ]
            },
            "TimeoutErrorResponseContent": {
                "type": "object",
                "description": "The request timed out before the service could complete it.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 408,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/TimeoutErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "TimeoutErrorType": {
                "type": "string",
                "description": "Problem type URI for timeout errors.",
                "enum": [
                    "/errors/timeout"
                ]
            },
            "TooManyRequestsErrorResponseContent": {
                "type": "object",
                "description": "The service rejected the request because rate limits were exceeded.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 429,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/TooManyRequestsErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "TooManyRequestsErrorType": {
                "type": "string",
                "description": "Problem type URI for rate-limit errors.",
                "enum": [
                    "/errors/too-many-requests"
                ]
            },
            "TopicsFilter": {
                "type": "object",
                "description": "Filter by topics. Matching is case-insensitive.",
                "properties": {
                    "eq": {
                        "type": "string",
                        "description": "Equals the given value."
                    },
                    "ne": {
                        "type": "string",
                        "description": "Not equal to the given value."
                    },
                    "in": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Matches any of the given values."
                    },
                    "all": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Matches all of the given values."
                    }
                }
            },
            "UnexpectedErrorResponseContent": {
                "type": "object",
                "description": "The service failed with an unexpected internal error.",
                "properties": {
                    "title": {
                        "type": "string",
                        "description": "A short, human-readable summary of the problem\n                                      type.  It SHOULD NOT change from occurrence to occurrence of the\n                                      problem, except for purposes of localization (e.g., using\n                                      proactive content negotiation; see [RFC7231], Section 3.4)."
                    },
                    "status": {
                        "type": "integer",
                        "default": 500,
                        "description": "The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.",
                        "format": "int32"
                    },
                    "detail": {
                        "type": "string",
                        "description": "A human-readable explanation specific to this occurrence of the problem."
                    },
                    "instance": {
                        "type": "string",
                        "description": "A URI reference that identifies the specific occurrence of the problem.  It may or may not yield further information if dereferenced."
                    },
                    "type": {
                        "$ref": "#/components/schemas/UnexpectedErrorType"
                    }
                },
                "required": [
                    "status",
                    "title",
                    "type"
                ]
            },
            "UnexpectedErrorType": {
                "type": "string",
                "description": "Problem type URI for unexpected internal errors.",
                "enum": [
                    "/errors/unexpected-error",
                    "/errors/content-integrity-failed"
                ]
            },
            "UpdateLongTermMemoryFieldsRequestContent": {
                "type": "object",
                "description": "Type- and namespace-scoped field update request for a custom-typed long-term memory record.",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409."
                    },
                    "expectedRevision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "The caller's bound memory type. The update is rejected unless the record's stored memoryType matches."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "The caller's current namespace. The update is rejected with 409 unless the record is still in it. Omit it to assert that the record has no namespace placement; omission does not mean \"any namespace\"."
                    },
                    "text": {
                        "type": "string",
                        "maxLength": 50000,
                        "minLength": 1,
                        "description": "Updated text content (1-50000 chars). Omit to leave the text unchanged."
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    }
                },
                "required": [
                    "memoryType"
                ]
            },
            "UpdateLongTermMemoryRequestContent": {
                "type": "object",
                "description": "Partial update request for a long-term memory record.",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409."
                    },
                    "expectedRevision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write."
                    },
                    "text": {
                        "type": "string",
                        "maxLength": 50000,
                        "minLength": 1,
                        "description": "Updated text content (1-50000 chars)."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Updated memory type. Built-in or a custom type registered on the store."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50,
                        "description": "Updated topics (max 50 topics, each 1-100 chars)."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Updated namespace placement."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Updated owner ID. When provided, must follow the ActorId rules; omit the field to leave unchanged. Clearing is not supported because ownerId is required."
                    },
                    "sessionId": {
                        "type": "string",
                        "description": "Updated session ID. When provided, must be 1-64 chars alphanumeric and dashes; omit the field or send an empty string to clear."
                    }
                }
            },
            "UpdateLongTermMemoryResponseContent": {
                "type": "object",
                "description": "A long-term memory record.",
                "properties": {
                    "revision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Opaque revision for conditional writes. Legacy search results can omit it; read the memory by ID before a conditional update."
                    },
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Unique memory record ID."
                    },
                    "text": {
                        "type": "string",
                        "description": "The memory content."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Type of memory. Built-in or a custom type registered on the store."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session ID associated with this memory."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Owner ID associated with this memory."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Current namespace. Absent when the record has no namespace."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50,
                        "description": "Topic tags for categorization."
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    },
                    "createdAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was created (UTC).",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "description": "Timestamp when the memory was last updated (UTC).",
                        "format": "date-time"
                    },
                    "sources": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/MemorySourceLink"
                        },
                        "description": "Generic source links for this memory. Document sources include the customer document ID and revision that produced the memory."
                    },
                    "sourcesNextCursor": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 1,
                        "description": "Opaque token for additional source links when this response truncated attribution. Absent when every link is included."
                    },
                    "documentManaged": {
                        "type": "boolean",
                        "description": "True when this memory was created by document ingestion and is protected from generic overwrite."
                    }
                },
                "required": [
                    "createdAt",
                    "memoryId",
                    "text",
                    "updatedAt"
                ]
            },
            "UpdateNamespaceRequestContent": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z0-9_-]+$",
                        "description": "One case-sensitive namespace path segment."
                    },
                    "state": {
                        "$ref": "#/components/schemas/NamespaceUpdateState"
                    }
                }
            },
            "UpdateNamespaceResponseContent": {
                "type": "object",
                "properties": {
                    "namespace": {
                        "$ref": "#/components/schemas/Namespace"
                    }
                },
                "required": [
                    "namespace"
                ]
            },
            "UpdateSummaryViewRequestContent": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "New description. Send an empty string to clear it."
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "clearFilter": {
                        "type": "boolean",
                        "description": "Clear the saved filter. Mutually exclusive with filter."
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "clearTimeWindow": {
                        "type": "boolean",
                        "description": "Clear the rolling time window. Mutually exclusive with timeWindowSeconds."
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    },
                    "state": {
                        "$ref": "#/components/schemas/MutableSummaryViewState"
                    }
                }
            },
            "UpdateSummaryViewResponseContent": {
                "type": "object",
                "description": "A Summary View definition. Results are separate derived state and never enter long-term-memory search.",
                "properties": {
                    "viewId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^sv_[0-9a-f]{32}$",
                        "description": "Server-generated Summary View identifier: sv_ followed by 32 lowercase hex characters."
                    },
                    "ownerId": {
                        "type": "string",
                        "description": "Immutable canonical user ID assigned by the server. Empty when ownership enforcement is disabled and the caller has no canonical user ID. Clients cannot set ownership."
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/SummaryViewVisibility"
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "description": "Display name of any API resource."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 1024,
                        "minLength": 0,
                        "description": "Free-text description of any API resource. May be empty."
                    },
                    "source": {
                        "$ref": "#/components/schemas/SummaryViewSource"
                    },
                    "filter": {
                        "$ref": "#/components/schemas/LongTermMemoryFilter"
                    },
                    "groupBy": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/SummaryViewGroupField"
                        },
                        "maxItems": 4
                    },
                    "evictionPolicy": {
                        "$ref": "#/components/schemas/SummaryViewEvictionPolicy"
                    },
                    "timeWindowSeconds": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "output": {
                        "$ref": "#/components/schemas/SummaryViewOutputConfig"
                    },
                    "refreshPolicy": {
                        "$ref": "#/components/schemas/SummaryViewRefreshPolicy"
                    },
                    "definitionVersion": {
                        "type": "integer",
                        "minimum": 1,
                        "format": "int64"
                    },
                    "state": {
                        "$ref": "#/components/schemas/SummaryViewState"
                    },
                    "createdAt": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "updatedAt": {
                        "type": "string",
                        "format": "date-time"
                    }
                },
                "required": [
                    "createdAt",
                    "definitionVersion",
                    "groupBy",
                    "name",
                    "output",
                    "ownerId",
                    "refreshPolicy",
                    "source",
                    "state",
                    "updatedAt",
                    "viewId",
                    "visibility"
                ]
            },
            "UpsertLongTermMemoryRequestContent": {
                "type": "object",
                "properties": {
                    "idempotencyKey": {
                        "type": "string",
                        "maxLength": 128,
                        "minLength": 1,
                        "pattern": "^[ -~]+$",
                        "description": "Reuse the same key and original request to replay the saved result during the retry window (at most 24 hours, capped by the store memory TTL). Reusing the key with a different request returns 409."
                    },
                    "expectedRevision": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "description": "Apply the write only if this revision is current. A stale revision returns 412. Omit for an unconditional write."
                    },
                    "text": {
                        "type": "string",
                        "maxLength": 50000,
                        "minLength": 1,
                        "description": "Memory text content (1-50000 chars)."
                    },
                    "ownerId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^(?:[\\w+=@-][\\w+=.@-]*|\\.[\\w+=@-][\\w+=.@-]*|\\.\\.[\\w+=.@-]+)$",
                        "description": "Actor/owner identifier: a user ID (1-64 chars: letters, digits and _+=.@-, not . or .., case-sensitive). Used for users, agents, or other participants."
                    },
                    "memoryType": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
                        "description": "Identifier of a long-term memory type.\n\nBuilt-in types include `semantic`, `episodic`, `message`, and `session_summary`.\nThe legacy `session_summary_view` name remains reserved. Search filters for either\nsummary name match both, except on stores with an existing custom `session_summary`\ntype, where each name retains its separate meaning.\nStores may also register custom memory types; this open string accepts any\nregistered type name.\n\nConstraints: 1-64 chars, must start with a letter, followed by letters, digits,\nunderscores, or dashes."
                    },
                    "sessionId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Session identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). When the server generates one, it uses 32 lowercase hex characters."
                    },
                    "namespaceId": {
                        "type": "string",
                        "maxLength": 35,
                        "minLength": 35,
                        "pattern": "^ns_[0-9a-f]{32}$",
                        "description": "Server-generated namespace identifier: ns_ followed by 32 lowercase hex characters."
                    },
                    "topics": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "maxLength": 100,
                            "minLength": 1,
                            "description": "Topic name (1-100 chars)."
                        },
                        "maxItems": 50
                    },
                    "attributes": {
                        "$ref": "#/components/schemas/AttributeMap"
                    }
                },
                "required": [
                    "ownerId",
                    "text"
                ]
            },
            "UpsertLongTermMemoryResponseContent": {
                "type": "object",
                "properties": {
                    "memoryId": {
                        "type": "string",
                        "maxLength": 64,
                        "minLength": 1,
                        "pattern": "^[A-Za-z0-9_-]+$",
                        "description": "Memory record identifier (1-64 chars: letters, digits, underscores and hyphens, case-sensitive). Client-provided for idempotent long-term memory creation."
                    },
                    "created": {
                        "type": "boolean"
                    }
                },
                "required": [
                    "created",
                    "memoryId"
                ]
            }
        },
        "securitySchemes": {
            "smithy.api.httpBearerAuth": {
                "type": "http",
                "description": "HTTP Bearer authentication",
                "scheme": "Bearer"
            }
        }
    },
    "security": [
        {
            "smithy.api.httpBearerAuth": []
        }
    ]
}
