@arke-institute/sdk 2.3.5 → 2.3.7

package/dist/generated/index.d.cts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-01-05T15:10:38.577Z
+ * Generated: 2026-01-12T16:14:47.577Z
  */
 type paths = {
     "/auth/register": {
@@ -491,6 +491,106 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/users/{id}/collections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List collections user has access to
+         * @description Returns all collections where the user has a role relationship (owner, editor, viewer, etc.).
+         *
+         *     Queries GraphDB for collections with relationships pointing to this user where peer_type is 'user'.
+         *     Results include the role predicate so clients know what access the user has to each collection.
+         *
+         *     Supports filtering by predicate (role name) and pagination.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    predicate?: string;
+                    limit?: string;
+                    offset?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description List of collections */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["UserCollectionsResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description GraphDB service unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/collections": {
         parameters: {
             query?: never;
@@ -2453,7 +2553,7 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/files": {
+    "/connect": {
         parameters: {
             query?: never;
             header?: never;
@@ -2463,18 +2563,16 @@ type paths = {
         get?: never;
         put?: never;
         /**
-         * Create file entity
-         * @description Creates a new file entity.
+         * Connect two entities
+         * @description Creates a unidirectional relationship from source to target entity.
          *
-         *     ## Flow
-         *     1. Call this endpoint with file metadata (key, filename, content_type, size)
-         *     2. Receive entity data (uploaded: false)
-         *     3. POST the file content to /{id}/content
-         *     4. Entity will be updated with uploaded: true and verified CID
+         *     This is a shorthand for adding a relationship with sensible defaults:
+         *     - Default predicate: `connects_to` (customizable)
+         *     - Optional label and description stored in relationship properties
+         *     - Only requires `entity:update` permission on source entity
          *
-         *     ## Key Best Practice
-         *     Use a unique identifier as the key (e.g., version number, timestamp).
-         *     The actual CID is computed during upload.
+         *     Use this for simple entity linking. For bidirectional relationships or
+         *     advanced options, use the `/relationships` endpoint.
          */
         post: {
             parameters: {
@@ -2485,17 +2583,17 @@ type paths = {
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["CreateFileRequest"];
+                    "application/json": components["schemas"]["ConnectRequest"];
                 };
             };
             responses: {
-                /** @description File entity created */
+                /** @description Connection created */
                 201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CreateFileResponse"];
+                        "application/json": components["schemas"]["ConnectResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -2537,38 +2635,52 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Conflict - CAS validation failed (entity was modified) */
-                409: {
+                /** @description Forbidden - Insufficient permissions */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "error": "Conflict: entity was modified",
-                         *       "details": {
-                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
-                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
-                         *       }
+                         *       "error": "Forbidden: You do not have permission to perform this action"
                          *     }
                          */
-                        "application/json": components["schemas"]["CASErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Internal Server Error */
-                500: {
+                /** @description Not Found - Resource does not exist */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "error": "Internal server error"
+                         *       "error": "Entity not found"
                          *     }
                          */
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["CASErrorResponse"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -2577,101 +2689,45 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/files/{id}": {
+    "/connect/disconnect": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get file metadata
-         * @description Returns file entity metadata. Use /{id}/content to download the file content.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description File found */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["FileResponse"];
-                    };
-                };
-                /** @description Forbidden - Insufficient permissions */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Forbidden: You do not have permission to perform this action"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Not Found - Resource does not exist */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Entity not found"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-            };
-        };
-        /**
-         * Update file metadata
-         * @description Updates file metadata without changing the file content.
+         * Disconnect two entities
+         * @description Removes a unidirectional relationship from source to target entity.
          *
-         *     ## Key Changes
-         *     The key can be changed, but ONLY to a key that already exists in R2.
-         *     This allows "regressing" to a previous file version.
+         *     This is a shorthand for removing a relationship:
+         *     - Default predicate: `connects_to` (customizable)
+         *     - Only requires `entity:update` permission on source entity
          *
-         *     To upload a new file, use POST /{id}/reupload instead.
+         *     For bidirectional removal, use the `/relationships` endpoint.
          */
-        put: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["UpdateFileRequest"];
+                    "application/json": components["schemas"]["DisconnectRequest"];
                 };
             };
             responses: {
-                /** @description File updated */
+                /** @description Connection removed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["UpdateFileResponse"];
+                        "application/json": components["schemas"]["DisconnectResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -2761,54 +2817,368 @@ type paths = {
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/files/{id}/content": {
+    "/files": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Download file content
-         * @description Downloads the binary content of a file entity.
+         * Create file entity
+         * @description Creates a new file entity.
          *
-         *     ## Response Headers
-         *     - Content-Type: The MIME type of the file
-         *     - Content-Length: File size in bytes
-         *     - Content-Disposition: attachment; filename="original_filename"
+         *     ## Flow
+         *     1. Call this endpoint with file metadata (key, filename, content_type, size)
+         *     2. Receive entity data (uploaded: false)
+         *     3. POST the file content to /{id}/content
+         *     4. Entity will be updated with uploaded: true and verified CID
          *
-         *     ## Streaming
-         *     Response is streamed directly from R2 storage.
+         *     ## Key Best Practice
+         *     Use a unique identifier as the key (e.g., version number, timestamp).
+         *     The actual CID is computed during upload.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CreateFileRequest"];
+                };
+            };
             responses: {
-                /** @description File content */
-                200: {
+                /** @description File entity created */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/octet-stream": string;
+                        "application/json": components["schemas"]["CreateFileResponse"];
                     };
                 };
-                /** @description Forbidden - Insufficient permissions */
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
+                         *       "details": {
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["CASErrorResponse"];
+                    };
+                };
+                /** @description Internal Server Error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Internal server error"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/files/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get file metadata
+         * @description Returns file entity metadata. Use /{id}/content to download the file content.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description File found */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["FileResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        /**
+         * Update file metadata
+         * @description Updates file metadata without changing the file content.
+         *
+         *     ## Key Changes
+         *     The key can be changed, but ONLY to a key that already exists in R2.
+         *     This allows "regressing" to a previous file version.
+         *
+         *     To upload a new file, use POST /{id}/reupload instead.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["UpdateFileRequest"];
+                };
+            };
+            responses: {
+                /** @description File updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["UpdateFileResponse"];
+                    };
+                };
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
+                         *       "details": {
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["CASErrorResponse"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/files/{id}/content": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download file content
+         * @description Downloads the binary content of a file entity.
+         *
+         *     ## Response Headers
+         *     - Content-Type: The MIME type of the file
+         *     - Content-Length: File size in bytes
+         *     - Content-Disposition: attachment; filename="original_filename"
+         *
+         *     ## Streaming
+         *     Response is streamed directly from R2 storage.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description File content */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/octet-stream": string;
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -3278,55 +3648,327 @@ type paths = {
                     content: {
                         /**
                          * @example {
-                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        /**
+         * Update folder
+         * @description Updates folder properties (label, description, metadata). Properties are merged.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["UpdateFolderRequest"];
+                };
+            };
+            responses: {
+                /** @description Folder updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["UpdateFolderResponse"];
+                    };
+                };
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
+                         *       "details": {
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["CASErrorResponse"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/folders/{id}/children": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Add child to folder
+         * @description Adds a child entity (file or folder) to this folder.
+         *
+         *     Creates bidirectional relationship:
+         *     - Folder contains child
+         *     - Child is in folder
+         *
+         *     **Idempotent**: if relationship already exists, returns current state without error.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["AddChildRequest"];
+                };
+            };
+            responses: {
+                /** @description Child added */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AddChildResponse"];
+                    };
+                };
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
+                         *       "details": {
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
                          *     }
                          */
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Not Found - Resource does not exist */
-                404: {
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "error": "Entity not found"
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
                          *     }
                          */
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["CASErrorResponse"];
                     };
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/folders/{id}/children/{childId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
         /**
-         * Update folder
-         * @description Updates folder properties (label, description, metadata). Properties are merged.
+         * Remove child from folder
+         * @description Removes a child entity from this folder (bidirectional).
          */
-        put: {
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
                     id: string;
+                    /** @description Child entity ID */
+                    childId: string;
                 };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["UpdateFolderRequest"];
+                    "application/json": components["schemas"]["RemoveChildRequest"];
                 };
             };
             responses: {
-                /** @description Folder updated */
+                /** @description Child removed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["UpdateFolderResponse"];
+                        "application/json": components["schemas"]["RemoveChildResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -3416,14 +4058,12 @@ type paths = {
                 };
             };
         };
-        post?: never;
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/folders/{id}/children": {
+    "/folders/{id}/children/bulk": {
         parameters: {
             query?: never;
             header?: never;
@@ -3433,14 +4073,18 @@ type paths = {
         get?: never;
         put?: never;
         /**
-         * Add child to folder
-         * @description Adds a child entity (file or folder) to this folder.
+         * Bulk add children to folder
+         * @description Efficiently adds multiple children to a folder.
          *
-         *     Creates bidirectional relationship:
-         *     - Folder contains child
-         *     - Child is in folder
+         *     **Limit**: Maximum 50 children per request. For larger batches, make multiple
+         *     requests, refetching the folder's CID between each to satisfy the CAS guard.
          *
-         *     **Idempotent**: if relationship already exists, returns current state without error.
+         *     **Strategy**:
+         *     1. Updates folder once with all 'contains' relationships
+         *     2. Updates each child in parallel with 'in' back-link
+         *
+         *     **Idempotent**: skips children that already have the relationship.
+         *     Returns both added and skipped children in the response.
          */
         post: {
             parameters: {
@@ -3454,17 +4098,17 @@ type paths = {
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["AddChildRequest"];
+                    "application/json": components["schemas"]["BulkAddChildrenRequest"];
                 };
             };
             responses: {
-                /** @description Child added */
+                /** @description Children added */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AddChildResponse"];
+                        "application/json": components["schemas"]["BulkAddChildrenResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -3560,7 +4204,7 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/folders/{id}/children/{childId}": {
+    "/folders/{id}/parents": {
         parameters: {
             query?: never;
             header?: never;
@@ -3569,36 +4213,39 @@ type paths = {
         };
         get?: never;
         put?: never;
-        post?: never;
         /**
-         * Remove child from folder
-         * @description Removes a child entity from this folder (bidirectional).
+         * Add parent to folder
+         * @description Adds this folder to a parent folder.
+         *
+         *     Creates bidirectional relationship:
+         *     - Parent contains this folder
+         *     - This folder is in parent
+         *
+         *     **Idempotent**: if relationship already exists, returns current state without error.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
                     id: string;
-                    /** @description Child entity ID */
-                    childId: string;
                 };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["RemoveChildRequest"];
+                    "application/json": components["schemas"]["AddParentRequest"];
                 };
             };
             responses: {
-                /** @description Child removed */
+                /** @description Parent added */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RemoveChildResponse"];
+                        "application/json": components["schemas"]["AddParentResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -3688,12 +4335,13 @@ type paths = {
                 };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/folders/{id}/children/bulk": {
+    "/folders/{id}/parents/{parentId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -3702,43 +4350,36 @@ type paths = {
         };
         get?: never;
         put?: never;
+        post?: never;
         /**
-         * Bulk add children to folder
-         * @description Efficiently adds multiple children to a folder.
-         *
-         *     **Limit**: Maximum 50 children per request. For larger batches, make multiple
-         *     requests, refetching the folder's CID between each to satisfy the CAS guard.
-         *
-         *     **Strategy**:
-         *     1. Updates folder once with all 'contains' relationships
-         *     2. Updates each child in parallel with 'in' back-link
-         *
-         *     **Idempotent**: skips children that already have the relationship.
-         *     Returns both added and skipped children in the response.
+         * Remove parent from folder
+         * @description Removes this folder from a parent folder (bidirectional).
          */
-        post: {
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
                     id: string;
+                    /** @description Parent folder ID */
+                    parentId: string;
                 };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["BulkAddChildrenRequest"];
+                    "application/json": components["schemas"]["RemoveParentRequest"];
                 };
             };
             responses: {
-                /** @description Children added */
+                /** @description Parent removed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["BulkAddChildrenResponse"];
+                        "application/json": components["schemas"]["RemoveParentResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -3828,34 +4469,30 @@ type paths = {
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/folders/{id}/parents": {
+    "/versions/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Add parent to folder
-         * @description Adds this folder to a parent folder.
-         *
-         *     Creates bidirectional relationship:
-         *     - Parent contains this folder
-         *     - This folder is in parent
-         *
-         *     **Idempotent**: if relationship already exists, returns current state without error.
+         * List version history
+         * @description Returns version metadata for an entity (newest first). Use pagination for entities with many versions.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Maximum versions to return (1-10, default 10) */
+                    limit?: number;
+                    /** @description CID to start from (for pagination) */
+                    from?: string;
+                };
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
@@ -3863,19 +4500,15 @@ type paths = {
                 };
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["AddParentRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Parent added */
+                /** @description Version list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AddParentResponse"];
+                        "application/json": components["schemas"]["VersionListResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -3903,20 +4536,76 @@ type paths = {
                         "application/json": components["schemas"]["ValidationErrorResponse"];
                     };
                 };
-                /** @description Unauthorized - Missing or invalid authentication */
-                401: {
+                /** @description Forbidden - Insufficient permissions */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
                          *     }
                          */
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/versions/manifest/{cid}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get manifest by CID
+         * @description Returns the full manifest for any version by its CID. Permission is checked against the entity ID in the manifest.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description IPFS Content Identifier (CID) of the manifest */
+                    cid: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Manifest found */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ManifestResponse"];
+                    };
+                };
                 /** @description Forbidden - Insufficient permissions */
                 403: {
                     headers: {
@@ -3945,33 +4634,63 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Conflict - CAS validation failed (entity was modified) */
-                409: {
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/permissions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get permission system metadata
+         * @description Returns all registered actions, verbs, types, verb implications, wildcard patterns, and default roles.
+         *
+         *     This endpoint is useful for:
+         *     - Building dynamic role editors
+         *     - Understanding available permissions
+         *     - Validating actions client-side
+         *
+         *     All data is auto-generated from the actual permission system, so it's always in sync with the code.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Permission system metadata */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        /**
-                         * @example {
-                         *       "error": "Conflict: entity was modified",
-                         *       "details": {
-                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
-                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
-                         *       }
-                         *     }
-                         */
-                        "application/json": components["schemas"]["CASErrorResponse"];
+                        "application/json": components["schemas"]["PermissionsResponse"];
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/folders/{id}/parents/{parentId}": {
+    "/agents": {
         parameters: {
             query?: never;
             header?: never;
@@ -3980,36 +4699,30 @@ type paths = {
         };
         get?: never;
         put?: never;
-        post?: never;
         /**
-         * Remove parent from folder
-         * @description Removes this folder from a parent folder (bidirectional).
+         * Create an agent
+         * @description Creates a new agent entity. Requires agent:create permission in the target collection.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                    /** @description Parent folder ID */
-                    parentId: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["RemoveParentRequest"];
+                    "application/json": components["schemas"]["CreateAgentRequest"];
                 };
             };
             responses: {
-                /** @description Parent removed */
-                200: {
+                /** @description Agent created */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RemoveParentResponse"];
+                        "application/json": components["schemas"]["AgentResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -4079,32 +4792,15 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Conflict - CAS validation failed (entity was modified) */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Conflict: entity was modified",
-                         *       "details": {
-                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
-                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
-                         *       }
-                         *     }
-                         */
-                        "application/json": components["schemas"]["CASErrorResponse"];
-                    };
-                };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/versions/{id}": {
+    "/agents/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -4112,17 +4808,12 @@ type paths = {
             cookie?: never;
         };
         /**
-         * List version history
-         * @description Returns version metadata for an entity (newest first). Use pagination for entities with many versions.
+         * Get agent by ID
+         * @description Returns an agent entity by ID.
          */
         get: {
             parameters: {
-                query?: {
-                    /** @description Maximum versions to return (1-10, default 10) */
-                    limit?: number;
-                    /** @description CID to start from (for pagination) */
-                    from?: string;
-                };
+                query?: never;
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
@@ -4132,38 +4823,13 @@ type paths = {
             };
             requestBody?: never;
             responses: {
-                /** @description Version list */
+                /** @description Agent found */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["VersionListResponse"];
-                    };
-                };
-                /** @description Bad Request - Invalid input */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Validation failed",
-                         *       "details": {
-                         *         "issues": [
-                         *           {
-                         *             "path": [
-                         *               "properties",
-                         *               "label"
-                         *             ],
-                         *             "message": "Required"
-                         *           }
-                         *         ]
-                         *       }
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                        "application/json": components["schemas"]["AgentResponse"];
                     };
                 };
                 /** @description Forbidden - Insufficient permissions */
@@ -4196,44 +4862,72 @@ type paths = {
                 };
             };
         };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/versions/manifest/{cid}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
         /**
-         * Get manifest by CID
-         * @description Returns the full manifest for any version by its CID. Permission is checked against the entity ID in the manifest.
+         * Update agent
+         * @description Updates an agent. Requires agent:update permission.
          */
-        get: {
+        put: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
-                    /** @description IPFS Content Identifier (CID) of the manifest */
-                    cid: string;
+                    /** @description Entity ID (ULID) */
+                    id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["UpdateAgentRequest"];
+                };
+            };
             responses: {
-                /** @description Manifest found */
+                /** @description Agent updated */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ManifestResponse"];
+                        "application/json": components["schemas"]["AgentUpdateResponse"];
+                    };
+                };
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
+                         *       "details": {
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 /** @description Forbidden - Insufficient permissions */
@@ -4264,55 +4958,26 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/permissions": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get permission system metadata
-         * @description Returns all registered actions, verbs, types, verb implications, wildcard patterns, and default roles.
-         *
-         *     This endpoint is useful for:
-         *     - Building dynamic role editors
-         *     - Understanding available permissions
-         *     - Validating actions client-side
-         *
-         *     All data is auto-generated from the actual permission system, so it's always in sync with the code.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Permission system metadata */
-                200: {
+                /** @description Conflict - CAS validation failed (entity was modified) */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["PermissionsResponse"];
+                        /**
+                         * @example {
+                         *       "error": "Conflict: entity was modified",
+                         *       "details": {
+                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
+                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *       }
+                         *     }
+                         */
+                        "application/json": components["schemas"]["CASErrorResponse"];
                     };
                 };
             };
         };
-        put?: never;
         post?: never;
         delete?: never;
         options?: never;
@@ -4320,7 +4985,7 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/agents": {
+    "/agents/{id}/invoke": {
         parameters: {
             query?: never;
             header?: never;
@@ -4330,29 +4995,47 @@ type paths = {
         get?: never;
         put?: never;
         /**
-         * Create an agent
-         * @description Creates a new agent entity. Requires agent:create permission in the target collection.
+         * Invoke an agent
+         * @description Invoke an agent to perform work on a target collection.
+         *
+         *     **Two-phase interaction:**
+         *     1. First call with `confirm: false` (default) returns a preview of permissions that will be granted
+         *     2. After user reviews and confirms, call again with `confirm: true` to execute
+         *
+         *     The agent receives temporal (time-limited) permissions on the target collection.
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["CreateAgentRequest"];
+                    "application/json": components["schemas"]["InvokeAgentRequest"];
+                };
+            };
+            responses: {
+                /** @description Invoke preview (confirm: false) or execution started (confirm: true) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InvokePreviewResponse"];
+                    };
                 };
-            };
-            responses: {
-                /** @description Agent created */
-                201: {
+                /** @description Agent execution started */
+                202: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AgentResponse"];
+                        "application/json": components["schemas"]["InvokeConfirmedResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -4430,7 +5113,7 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/agents/{id}": {
+    "/agents/{id}/keys": {
         parameters: {
             query?: never;
             header?: never;
@@ -4438,8 +5121,8 @@ type paths = {
             cookie?: never;
         };
         /**
-         * Get agent by ID
-         * @description Returns an agent entity by ID.
+         * List API keys for agent
+         * @description Lists all active API keys for the agent (without the actual key values).
          */
         get: {
             parameters: {
@@ -4453,13 +5136,27 @@ type paths = {
             };
             requestBody?: never;
             responses: {
-                /** @description Agent found */
+                /** @description API keys listed */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AgentResponse"];
+                        "application/json": components["schemas"]["ListAgentApiKeysResponse"];
+                    };
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 /** @description Forbidden - Insufficient permissions */
@@ -4492,11 +5189,12 @@ type paths = {
                 };
             };
         };
+        put?: never;
         /**
-         * Update agent
-         * @description Updates an agent. Requires agent:update permission.
+         * Create API key for agent
+         * @description Creates an API key for the agent. The full key is only returned once.
          */
-        put: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
@@ -4508,17 +5206,17 @@ type paths = {
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["UpdateAgentRequest"];
+                    "application/json": components["schemas"]["CreateAgentApiKeyRequest"];
                 };
             };
             responses: {
-                /** @description Agent updated */
-                200: {
+                /** @description API key created */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AgentUpdateResponse"];
+                        "application/json": components["schemas"]["CreateAgentApiKeyResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -4588,34 +5286,230 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Conflict - CAS validation failed (entity was modified) */
-                409: {
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/agents/{id}/keys/{prefix}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke API key
+         * @description Revokes an API key for the agent.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                    prefix: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description API key revoked */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Unauthorized - Missing or invalid authentication */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         /**
                          * @example {
-                         *       "error": "Conflict: entity was modified",
+                         *       "error": "Unauthorized: Missing or invalid authentication token"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Forbidden - Insufficient permissions */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Forbidden: You do not have permission to perform this action"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List entity change events
+         * @description Returns a cursor-based list of entity change events for client synchronization.
+         *
+         *     **Usage:**
+         *     - Call without cursor to get newest events
+         *     - Use returned `cursor` as `?cursor=` to get older events
+         *     - Poll without cursor periodically to check for new events
+         *
+         *     **Sync flow:**
+         *     1. Initial: `GET /events` → get newest, save highest `id` as high-water mark
+         *     2. Paginate: `GET /events?cursor=X` → get older events until `has_more=false`
+         *     3. Poll: `GET /events` → if newest `id` > high-water mark, process new events
+         *
+         *     **Event data:**
+         *     - `id`: Auto-increment ID
+         *     - `pi`: Entity ID that changed
+         *     - `cid`: New manifest CID
+         *     - `ts`: ISO timestamp
+         *
+         *     Events are ephemeral (30-day rolling window) - for full sync, use snapshots.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Return events older than this id (from previous response cursor) */
+                    cursor?: number;
+                    /** @description Maximum number of events to return (default: 100, max: 1000) */
+                    limit?: number;
+                    /** @description Network to query (default: main) */
+                    network?: "main" | "test";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Events list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EventsListResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/graph/paths": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Find paths between entities
+         * @description Find shortest paths between source and target entity sets using graph traversal.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["PathsBetweenRequest"];
+                };
+            };
+            responses: {
+                /** @description Paths found */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PathsBetweenResponse"];
+                    };
+                };
+                /** @description Bad Request - Invalid input */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Validation failed",
                          *       "details": {
-                         *         "expected": "bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy",
-                         *         "actual": "bafyreinewabc123456789defghijklmnopqrstuvwxyz"
+                         *         "issues": [
+                         *           {
+                         *             "path": [
+                         *               "properties",
+                         *               "label"
+                         *             ],
+                         *             "message": "Required"
+                         *           }
+                         *         ]
                          *       }
                          *     }
                          */
-                        "application/json": components["schemas"]["CASErrorResponse"];
+                        "application/json": components["schemas"]["ValidationErrorResponse"];
                     };
                 };
             };
         };
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/agents/{id}/invoke": {
+    "/graph/reachable": {
         parameters: {
             query?: never;
             header?: never;
@@ -4625,47 +5519,29 @@ type paths = {
         get?: never;
         put?: never;
         /**
-         * Invoke an agent
-         * @description Invoke an agent to perform work on a target collection.
-         *
-         *     **Two-phase interaction:**
-         *     1. First call with `confirm: false` (default) returns a preview of permissions that will be granted
-         *     2. After user reviews and confirms, call again with `confirm: true` to execute
-         *
-         *     The agent receives temporal (time-limited) permissions on the target collection.
+         * Find reachable entities
+         * @description Find all entities of a specific type reachable from source entities within N hops.
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["InvokeAgentRequest"];
+                    "application/json": components["schemas"]["PathsReachableRequest"];
                 };
             };
             responses: {
-                /** @description Invoke preview (confirm: false) or execution started (confirm: true) */
+                /** @description Reachable entities found */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InvokePreviewResponse"];
-                    };
-                };
-                /** @description Agent execution started */
-                202: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["InvokeConfirmedResponse"];
+                        "application/json": components["schemas"]["PathsReachableResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -4693,48 +5569,6 @@ type paths = {
                         "application/json": components["schemas"]["ValidationErrorResponse"];
                     };
                 };
-                /** @description Unauthorized - Missing or invalid authentication */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Unauthorized: Missing or invalid authentication token"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Insufficient permissions */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Forbidden: You do not have permission to perform this action"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Not Found - Resource does not exist */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Entity not found"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
             };
         };
         delete?: never;
@@ -4743,7 +5577,7 @@ type paths = {
         patch?: never;
         trace?: never;
     };
-    "/agents/{id}/keys": {
+    "/graph/entity/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -4751,8 +5585,8 @@ type paths = {
             cookie?: never;
         };
         /**
-         * List API keys for agent
-         * @description Lists all active API keys for the agent (without the actual key values).
+         * Get entity from graph
+         * @description Get entity details with all relationships from the graph database.
          */
         get: {
             parameters: {
@@ -4766,41 +5600,13 @@ type paths = {
             };
             requestBody?: never;
             responses: {
-                /** @description API keys listed */
+                /** @description Entity found */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ListAgentApiKeysResponse"];
-                    };
-                };
-                /** @description Unauthorized - Missing or invalid authentication */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Unauthorized: Missing or invalid authentication token"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Forbidden - Insufficient permissions */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        /**
-                         * @example {
-                         *       "error": "Forbidden: You do not have permission to perform this action"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["GraphEntityResponse"];
                     };
                 };
                 /** @description Not Found - Resource does not exist */
@@ -4820,33 +5626,79 @@ type paths = {
             };
         };
         put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Create API key for agent
-         * @description Creates an API key for the agent. The full key is only returned once.
+         * Execute Argo query
+         * @description Execute an Argo DSL query for path-based graph traversal.
+         *
+         *     ## Query Syntax
+         *
+         *     ```
+         *     ENTRY_POINT [ENTRY_FILTER] [-[RELATION]{DEPTH}-> TARGET_FILTER]...
+         *     ```
+         *
+         *     ### Entry Points
+         *
+         *     | Syntax | Description | Example |
+         *     |--------|-------------|---------|
+         *     | `"text"` | Semantic search | `"george washington"` |
+         *     | `@id` | Exact entity ID | `@01KE4ZY69F9R40E88PK9S0TQRQ` |
+         *     | `type:X` | All entities of type | `type:person` |
+         *     | `type:X ~ "text"` | Semantic search within type | `type:person ~ "physician"` |
+         *
+         *     ### Edges (Hops)
+         *
+         *     | Syntax | Direction |
+         *     |--------|-----------|
+         *     | `-[*]->` | Outgoing |
+         *     | `<-[*]-` | Incoming |
+         *     | `<-[*]->` | Both |
+         *     | `-[*]{,4}->` | Variable depth (1-4) |
+         *
+         *     ### Examples
+         *
+         *     ```
+         *     "george washington"                           # Simple semantic search
+         *     "albert einstein" type:person                 # With type filter
+         *     "medical college" -[*]{,4}-> type:file        # Find files connected to concept
+         *     @01KE4ZY... -[*]{,2}-> type:person            # Find people near entity
+         *     ```
          */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Entity ID (ULID) */
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["CreateAgentApiKeyRequest"];
+                    "application/json": components["schemas"]["QueryRequest"];
                 };
             };
             responses: {
-                /** @description API key created */
-                201: {
+                /** @description Query executed successfully */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CreateAgentApiKeyResponse"];
+                        "application/json": components["schemas"]["QueryResponse"];
                     };
                 };
                 /** @description Bad Request - Invalid input */
@@ -4874,18 +5726,55 @@ type paths = {
                         "application/json": components["schemas"]["ValidationErrorResponse"];
                     };
                 };
-                /** @description Unauthorized - Missing or invalid authentication */
-                401: {
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/entities/{id}/attestation": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get latest attestation
+         * @description Returns the Arweave attestation for the current (latest) version of an entity.
+         *
+         *     Returns 202 Accepted if the attestation upload is still pending.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Attestation found */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        /**
-                         * @example {
-                         *       "error": "Unauthorized: Missing or invalid authentication token"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["AttestationResponse"];
+                    };
+                };
+                /** @description Attestation pending */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AttestationPendingResponse"];
                     };
                 };
                 /** @description Forbidden - Insufficient permissions */
@@ -4918,58 +5807,46 @@ type paths = {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/agents/{id}/keys/{prefix}": {
+    "/versions/{id}/{ver}/attestation": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        post?: never;
         /**
-         * Revoke API key
-         * @description Revokes an API key for the agent.
+         * Get version attestation
+         * @description Returns the Arweave attestation for a specific version of an entity.
          */
-        delete: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path: {
                     /** @description Entity ID (ULID) */
                     id: string;
-                    prefix: string;
+                    /** @description Version number */
+                    ver: number;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description API key revoked */
-                204: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content?: never;
-                };
-                /** @description Unauthorized - Missing or invalid authentication */
-                401: {
+                /** @description Attestation found */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        /**
-                         * @example {
-                         *       "error": "Unauthorized: Missing or invalid authentication token"
-                         *     }
-                         */
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["AttestationResponse"];
                     };
                 };
                 /** @description Forbidden - Insufficient permissions */
@@ -5002,12 +5879,15 @@ type paths = {
                 };
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/events": {
+    "/attestations/verify/{tx}": {
         parameters: {
             query?: never;
             header?: never;
@@ -5015,50 +5895,44 @@ type paths = {
             cookie?: never;
         };
         /**
-         * List entity change events
-         * @description Returns a cursor-based list of entity change events for client synchronization.
-         *
-         *     **Usage:**
-         *     - Call without cursor to get newest events
-         *     - Use returned `cursor` as `?cursor=` to get older events
-         *     - Poll without cursor periodically to check for new events
-         *
-         *     **Sync flow:**
-         *     1. Initial: `GET /events` → get newest, save highest `id` as high-water mark
-         *     2. Paginate: `GET /events?cursor=X` → get older events until `has_more=false`
-         *     3. Poll: `GET /events` → if newest `id` > high-water mark, process new events
+         * Verify attestation
+         * @description Fetches an attestation from Arweave and verifies the CID matches the manifest content.
          *
-         *     **Event data:**
-         *     - `id`: Auto-increment ID
-         *     - `pi`: Entity ID that changed
-         *     - `cid`: New manifest CID
-         *     - `ts`: ISO timestamp
-         *
-         *     Events are ephemeral (30-day rolling window) - for full sync, use snapshots.
+         *     This is a public endpoint - anyone can verify attestations.
          */
         get: {
             parameters: {
-                query?: {
-                    /** @description Return events older than this id (from previous response cursor) */
-                    cursor?: number;
-                    /** @description Maximum number of events to return (default: 100, max: 1000) */
-                    limit?: number;
-                    /** @description Network to query (default: main) */
-                    network?: "main" | "test";
-                };
+                query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    /** @description Arweave transaction ID */
+                    tx: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Events list */
+                /** @description Verification result */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EventsListResponse"];
+                        "application/json": components["schemas"]["VerifyAttestationResponse"];
+                    };
+                };
+                /** @description Not Found - Resource does not exist */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "error": "Entity not found"
+                         *     }
+                         */
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
             };
@@ -5078,7 +5952,7 @@ type components = {
             /** @example 01J1SHMAE10000000000000000 */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -5123,7 +5997,7 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -5338,6 +6212,48 @@ type components = {
             /** @description List of API keys */
             keys: components["schemas"]["ApiKeyInfo"][];
         };
+        UserCollectionItem: {
+            /**
+             * @description Collection persistent identifier
+             * @example 01JCOLLECTION123456789AB
+             */
+            pi: string;
+            /**
+             * @description Collection label/name
+             * @example My Research Collection
+             */
+            label: string;
+            /**
+             * @description Role predicate indicating user's relationship to collection
+             * @example owner
+             */
+            predicate: string;
+            /**
+             * @description When the collection was created
+             * @example 2026-01-12T00:00:00.000Z
+             */
+            created_at: string;
+        };
+        UserCollectionsResponse: {
+            /**
+             * @description User persistent identifier
+             * @example 01JUSER123456789ABCDEFGH
+             */
+            user_id: string;
+            /** @description Collections the user has access to */
+            collections: components["schemas"]["UserCollectionItem"][];
+            /** @description Pagination metadata */
+            pagination: {
+                /** @description Current offset */
+                offset: number;
+                /** @description Results per page */
+                limit: number;
+                /** @description Number of results returned */
+                count: number;
+                /** @description Whether more results exist */
+                has_more: boolean;
+            };
+        };
         CollectionResponse: components["schemas"]["EntityResponse"] & {
             /** @enum {string} */
             type?: "collection";
@@ -5499,12 +6415,12 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             prev_cid: string;
@@ -5609,12 +6525,12 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             prev_cid: string;
@@ -5666,12 +6582,12 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             prev_cid: string;
@@ -5749,7 +6665,7 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -5920,7 +6836,7 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -5935,7 +6851,7 @@ type components = {
              */
             ver: number;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             prev_cid: string;
@@ -6072,6 +6988,76 @@ type components = {
              */
             expect_target_tip?: string;
         };
+        ConnectResponse: {
+            source: components["schemas"]["EntityResponse"] & unknown;
+        };
+        ConnectRequest: {
+            /**
+             * @description Optional note describing this change
+             * @example Added Chapter 42: The Whiteness of the Whale
+             */
+            note?: string;
+            /**
+             * @description Source entity ID (the entity you're connecting FROM)
+             * @example 01JFKY3XQWM0MJVKM8DK3AEXPY
+             */
+            source_id: string;
+            /**
+             * @description Target entity ID (the entity you're connecting TO)
+             * @example 01JFKY3XQWM0MJVKM8DK3AEXQZ
+             */
+            target_id: string;
+            /**
+             * @description Expected current tip CID of source entity
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            expect_tip: string;
+            /**
+             * @description Relationship predicate. Defaults to "connects_to".
+             * @example connects_to
+             */
+            predicate?: string;
+            /**
+             * @description Optional display label for this connection
+             * @example Related document
+             */
+            label?: string;
+            /**
+             * @description Optional description explaining why this connection exists
+             * @example Links to the supporting research paper
+             */
+            description?: string;
+        };
+        DisconnectResponse: {
+            source: components["schemas"]["EntityResponse"] & unknown;
+        };
+        DisconnectRequest: {
+            /**
+             * @description Optional note describing this change
+             * @example Added Chapter 42: The Whiteness of the Whale
+             */
+            note?: string;
+            /**
+             * @description Source entity ID
+             * @example 01JFKY3XQWM0MJVKM8DK3AEXPY
+             */
+            source_id: string;
+            /**
+             * @description Target entity ID (peer of the connection to remove)
+             * @example 01JFKY3XQWM0MJVKM8DK3AEXQZ
+             */
+            target_id: string;
+            /**
+             * @description Expected current tip CID of source entity
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            expect_tip: string;
+            /**
+             * @description Relationship predicate to remove. Defaults to "connects_to".
+             * @example connects_to
+             */
+            predicate?: string;
+        };
         CreateFileResponse: {
             /**
              * @description Entity ID (ULID format)
@@ -6079,7 +7065,7 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -6316,7 +7302,7 @@ type components = {
              */
             id: string;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -6501,7 +7487,7 @@ type components = {
                  */
                 id: string;
                 /**
-                 * @description IPFS Content Identifier (CID)
+                 * @description Content Identifier (CID) - content-addressed hash
                  * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
                  */
                 cid: string;
@@ -6539,7 +7525,7 @@ type components = {
                  */
                 id: string;
                 /**
-                 * @description IPFS Content Identifier (CID)
+                 * @description Content Identifier (CID) - content-addressed hash
                  * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
                  */
                 cid: string;
@@ -6572,7 +7558,7 @@ type components = {
                  */
                 id: string;
                 /**
-                 * @description IPFS Content Identifier (CID)
+                 * @description Content Identifier (CID) - content-addressed hash
                  * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
                  */
                 cid: string;
@@ -6666,7 +7652,7 @@ type components = {
              */
             ver: number;
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -6691,6 +7677,17 @@ type components = {
             };
             /** @description Optional note describing this version */
             note?: string;
+            /**
+             * @description Arweave transaction ID if this version has been attested
+             * @example abc123xyz...
+             */
+            arweave_tx?: string;
+            /**
+             * Format: uri
+             * @description Arweave gateway URL for the attestation
+             * @example https://arweave.net/abc123xyz...
+             */
+            arweave_url?: string;
         };
         VersionListResponse: {
             /**
@@ -6710,7 +7707,7 @@ type components = {
         };
         ManifestResponse: {
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             cid: string;
@@ -7068,6 +8065,7 @@ type components = {
             role: string;
             already_granted: boolean;
             expired?: boolean;
+            missing_actions?: boolean;
             /** Format: date-time */
             current_expires_at?: string;
         };
@@ -7106,7 +8104,7 @@ type components = {
             job_collection: string;
             grants: components["schemas"]["InvokeGrantResult"][];
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             target_cid: string;
@@ -7122,7 +8120,7 @@ type components = {
             retry_after?: number;
             grants: components["schemas"]["InvokeGrantResult"][];
             /**
-             * @description IPFS Content Identifier (CID)
+             * @description Content Identifier (CID) - content-addressed hash
              * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
              */
             target_cid: string;
@@ -7235,6 +8233,343 @@ type components = {
              */
             cursor: number;
         };
+        PathEdge: {
+            /**
+             * @description Source entity PI
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            subject_pi: string;
+            /** @description Source entity label */
+            subject_label: string;
+            /** @description Source entity type */
+            subject_type: string;
+            /** @description Relationship predicate */
+            predicate: string;
+            /**
+             * @description Target entity PI
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            object_pi: string;
+            /** @description Target entity label */
+            object_label: string;
+            /** @description Target entity type */
+            object_type: string;
+        };
+        PathResult: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            source_pi: string;
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            target_pi: string;
+            /** @description Path length (number of hops) */
+            length: number;
+            edges: components["schemas"]["PathEdge"][];
+        };
+        PathsBetweenResponse: {
+            paths: components["schemas"]["PathResult"][];
+            /** @description Whether results were truncated due to limit */
+            truncated: boolean;
+        };
+        PathsBetweenRequest: {
+            /**
+             * @description Starting entity PIs
+             * @example [
+             *       "01KE4ZY69F9R40E88PK9S0TQRQ"
+             *     ]
+             */
+            source_pis: string[];
+            /**
+             * @description Target entity PIs
+             * @example [
+             *       "01KE506KZGD8M2P1XK3VNQT4YR"
+             *     ]
+             */
+            target_pis: string[];
+            /**
+             * @description Maximum path depth (1-4)
+             * @default 4
+             * @example 3
+             */
+            max_depth: number;
+            /**
+             * @description Relationship traversal direction
+             * @default both
+             * @example both
+             * @enum {string}
+             */
+            direction: "outgoing" | "incoming" | "both";
+            /**
+             * @description Maximum number of paths to return
+             * @default 100
+             * @example 10
+             */
+            limit: number;
+        };
+        ReachableResult: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            source_pi: string;
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            target_pi: string;
+            target_label: string;
+            target_type: string;
+            /** @description Path length (number of hops) */
+            length: number;
+            edges: components["schemas"]["PathEdge"][];
+        };
+        PathsReachableResponse: {
+            results: components["schemas"]["ReachableResult"][];
+            /** @description Whether results were truncated due to limit */
+            truncated: boolean;
+        };
+        PathsReachableRequest: {
+            /**
+             * @description Starting entity PIs
+             * @example [
+             *       "01KE4ZY69F9R40E88PK9S0TQRQ"
+             *     ]
+             */
+            source_pis: string[];
+            /**
+             * @description Target entity type to find
+             * @example file
+             */
+            target_type: string;
+            /**
+             * @description Maximum path depth (1-4)
+             * @default 4
+             * @example 3
+             */
+            max_depth: number;
+            /**
+             * @description Relationship traversal direction
+             * @default both
+             * @example both
+             * @enum {string}
+             */
+            direction: "outgoing" | "incoming" | "both";
+            /**
+             * @description Maximum number of results to return
+             * @default 100
+             * @example 50
+             */
+            limit: number;
+        };
+        RelationshipInfo: {
+            /** @enum {string} */
+            direction: "outgoing" | "incoming";
+            predicate: string;
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            peer_pi: string;
+            peer_type: string;
+            peer_label: string;
+            properties: {
+                [key: string]: unknown;
+            };
+        };
+        GraphEntityResponse: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            pi: string;
+            type: string;
+            label: string;
+            collection_pi: string | null;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: date-time */
+            updated_at: string;
+            relationships: components["schemas"]["RelationshipInfo"][];
+        };
+        QueryEntity: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            pi: string;
+            type: string;
+            label: string;
+            collection_pi: string | null;
+        };
+        EntityStep: {
+            entity: string;
+            label?: string;
+            type?: string;
+            score?: number;
+        };
+        EdgeStep: {
+            edge: string;
+            /** @enum {string} */
+            direction: "outgoing" | "incoming";
+            score?: number;
+        };
+        PathStep: components["schemas"]["EntityStep"] | components["schemas"]["EdgeStep"];
+        QueryResultItem: {
+            entity: components["schemas"]["QueryEntity"];
+            path: components["schemas"]["PathStep"][];
+            score: number;
+        };
+        QueryMetadata: {
+            query: string;
+            hops: number;
+            k: number;
+            k_explore: number;
+            total_candidates_explored: number;
+            execution_time_ms: number;
+            collection?: string;
+            error?: string;
+            reason?: string;
+            partial_path?: components["schemas"]["PathStep"][];
+            stopped_at_hop?: number;
+        };
+        QueryResponse: {
+            results: components["schemas"]["QueryResultItem"][];
+            metadata: components["schemas"]["QueryMetadata"];
+        };
+        QueryRequest: {
+            /**
+             * @description Argo query string
+             * @example "medical college" -[*]{,4}-> type:file
+             */
+            path: string;
+            /**
+             * @description Maximum number of results to return
+             * @default 10
+             * @example 10
+             */
+            k: number;
+            /**
+             * @description Beam width for exploration (default: k * 3)
+             * @example 30
+             */
+            k_explore?: number;
+            /**
+             * @description Scope query to collection PI
+             * @example 01JCOLL_MEDICAL
+             */
+            collection?: string;
+        };
+        AttestationResponse: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            pi: string;
+            /**
+             * @description Entity version number
+             * @example 1
+             */
+            ver: number;
+            /**
+             * @description Content Identifier (CID) - content-addressed hash
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            cid: string;
+            /**
+             * @description Arweave transaction ID
+             * @example abc123xyz...
+             */
+            arweave_tx: string;
+            /**
+             * Format: uri
+             * @description Arweave gateway URL for direct access
+             * @example https://arweave.net/abc123xyz...
+             */
+            arweave_url: string;
+            /**
+             * @description Unix timestamp (milliseconds) of the operation
+             * @example 1704455200000
+             */
+            ts: number;
+        };
+        AttestationPendingResponse: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            pi: string;
+            /**
+             * @description Entity version number
+             * @example 1
+             */
+            ver: number;
+            /**
+             * @description Content Identifier (CID) - content-addressed hash
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            cid: string;
+            /**
+             * @description Attestation upload status
+             * @enum {string}
+             */
+            attestation_status: "pending";
+            /**
+             * @description Status message
+             * @example Attestation upload in progress
+             */
+            message: string;
+        };
+        VerifyAttestationResponse: {
+            arweave_tx: string;
+            attestation: {
+                /**
+                 * @description Entity ID (ULID format)
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                pi: string;
+                /**
+                 * @description Entity version number
+                 * @example 1
+                 */
+                ver: number;
+                /**
+                 * @description Content Identifier (CID) - content-addressed hash
+                 * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+                 */
+                cid: string;
+                /**
+                 * @description Operation type: C=Create, U=Update
+                 * @enum {string}
+                 */
+                op: "C" | "U";
+                /**
+                 * @description Visibility at time of operation
+                 * @enum {string}
+                 */
+                vis: "pub" | "priv";
+                /**
+                 * @description Previous version CID (null for creates)
+                 * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+                 */
+                prev_cid: string | null;
+                /** @description Unix timestamp (milliseconds) */
+                ts: number;
+            };
+            /** @description True if hash(manifest) matches the attested CID */
+            cid_valid: boolean;
+            /** @description Truncated preview of the manifest content */
+            manifest_preview: {
+                /**
+                 * @description Entity type
+                 * @example collection
+                 */
+                type: string;
+            };
+        };
     };
     responses: never;
     parameters: never;