@arke-institute/sdk 2.0.0 → 2.2.0

package/dist/generated/index.d.cts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2025-12-29T18:40:11.377Z
+ * Generated: 2026-01-01T03:48:16.864Z
  */
 type paths = {
     "/auth/register": {
@@ -1675,7 +1675,7 @@ type paths = {
         };
         /**
          * Update entity
-         * @description Updates any entity. Properties and relationships are replaced (not merged). Note: entity:update on a collection requires collection:update permission.
+         * @description Updates any entity with merge semantics. Properties are deep merged, relationships use upsert semantics. Use properties_remove and relationships_remove for deletions. Note: entity:update on a collection requires collection:update permission.
          */
         put: {
             parameters: {
@@ -2069,9 +2069,9 @@ type paths = {
          *
          *     ## Flow
          *     1. Call this endpoint with file metadata (key, filename, content_type, size)
-         *     2. Receive entity data + presigned S3 upload URL
+         *     2. Receive entity data + presigned S3 upload URL (uploaded: false)
          *     3. PUT the file content to the upload URL
-         *     4. File is now stored and accessible
+         *     4. Call POST /{id}/confirm-upload to verify and set uploaded: true
          *
          *     ## Key Best Practice
          *     Use the file's CID as the key for content-addressable storage.
@@ -2454,9 +2454,10 @@ type paths = {
          *
          *     ## Flow
          *     1. Call this endpoint with new key and file metadata
-         *     2. Receive updated entity + presigned upload URL
+         *     2. Receive updated entity + presigned upload URL (uploaded: false)
          *     3. PUT the new file content to the upload URL
-         *     4. Old file versions remain accessible via manifest history
+         *     4. Call POST /{id}/confirm-upload to verify and set uploaded: true
+         *     5. Old file versions remain accessible via manifest history
          *
          *     ## Key Requirement
          *     The new key must NOT already exist in S3 (no overwrites).
@@ -2580,6 +2581,149 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/files/{id}/confirm-upload": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Confirm upload completed
+         * @description Confirms that file content has been uploaded to S3.
+         *
+         *     ## Flow
+         *     1. Create file entity (POST /files) - sets uploaded: false
+         *     2. PUT file content to the presigned upload URL
+         *     3. Call this endpoint to confirm - verifies file exists in S3, sets uploaded: true
+         *
+         *     ## Verification
+         *     The server verifies the file exists in S3 before setting uploaded: true.
+         *     If the file doesn't exist, returns 400 error.
+         *
+         *     ## Idempotency
+         *     If already uploaded: true, returns success without modification.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["ConfirmUploadRequest"];
+                };
+            };
+            responses: {
+                /** @description Upload confirmed */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ConfirmUploadResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/folders": {
         parameters: {
             query?: never;
@@ -3148,6 +3292,9 @@ type paths = {
          * 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
@@ -4446,6 +4593,59 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List events
+         * @description Returns entity change events in reverse chronological order (newest first).
+         *
+         *     Each event represents a create or update operation on an entity. Use cursor-based pagination to walk through the event history.
+         *
+         *     **Use cases:**
+         *     - Syncing entity changes to external systems
+         *     - Building search indexes
+         *     - Change tracking and audit logs
+         *
+         *     **Note:** This endpoint is public. Access control is enforced at the entity level - if you don't have permission to view an entity, you won't be able to fetch its manifest even if you see an event for it.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Maximum events to return (1-100, default 50) */
+                    limit?: number;
+                    /** @description Event CID to continue from (for pagination) */
+                    cursor?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Event 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;
+    };
 };
 type components = {
     schemas: {
@@ -4586,26 +4786,68 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
-            /**
-             * @description Properties to merge with existing (partial update)
-             * @example {
-             *       "label": "Captain Ahab",
-             *       "bio": "Commander of the Pequod, hunter of the white whale"
-             *     }
-             */
+            /** @description Properties to add or update (deep merged) */
             properties?: {
                 [key: string]: unknown;
             };
-            /** @description Relationships to set (replaces existing) */
-            relationships?: {
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
                 predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
                 peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
                 peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
                 peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
                 properties?: {
                     [key: string]: unknown;
                 };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
             }[];
+            /**
+             * @description Updated display name
+             * @example Captain Ahab
+             */
+            label?: string;
         };
         CreateApiKeyResponse: {
             /**
@@ -4725,6 +4967,10 @@ type components = {
             roles?: {
                 [key: string]: string[];
             };
+            /** @description Additional properties to store */
+            properties?: {
+                [key: string]: unknown;
+            };
             /** @description Initial relationships */
             relationships?: {
                 predicate: string;
@@ -4754,6 +5000,63 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
+            /** @description Properties to add or update (deep merged) */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
+                peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
+                peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
+                properties?: {
+                    [key: string]: unknown;
+                };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
+            }[];
             /** @description Updated collection display name */
             label?: string;
             /** @description Updated collection description */
@@ -5086,42 +5389,63 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
-            /**
-             * @description Updated properties (replaces all existing properties)
-             * @example {
-             *       "label": "Chapter 1: Loomings (Revised)",
-             *       "author": "Herman Melville"
-             *     }
-             */
+            /** @description Properties to add or update (deep merged) */
             properties?: {
                 [key: string]: unknown;
             };
-            /** @description Updated relationships (replaces all existing relationships) */
-            relationships?: {
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
                 predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
                 peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
                 peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
                 peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
                 properties?: {
                     [key: string]: unknown;
                 };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
             }[];
-            /**
-             * @description Components to add or update (key → CID)
-             * @example {
-             *       "transcript.txt": "bafyrei..."
-             *     }
-             */
-            components?: {
-                [key: string]: string;
-            };
-            /**
-             * @description Component keys to remove
-             * @example [
-             *       "old_version.txt"
-             *     ]
-             */
-            components_remove?: string[];
         };
         AddRelationshipResponse: {
             source: components["schemas"]["EntityResponse"] & unknown;
@@ -5297,7 +5621,27 @@ type components = {
              */
             description?: string;
             /**
-             * @description Collection to add this file to (for permissions)
+             * @description Additional properties to store
+             * @example {
+             *       "source": "upload",
+             *       "category": "financial"
+             *     }
+             */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to create */
+            relationships?: {
+                predicate: string;
+                peer: string;
+                peer_type?: string;
+                peer_label?: string;
+                properties?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            /**
+             * @description Collection to add this file to (for permissions). Shortcut for adding a collection relationship.
              * @example 01KDETYWYWM0MJVKM8DK3AEXPY
              */
             collection?: string;
@@ -5353,6 +5697,63 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
+            /** @description Properties to add or update (deep merged) */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
+                peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
+                peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
+                properties?: {
+                    [key: string]: unknown;
+                };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
+            }[];
             /** @description New storage key. Must already exist in S3 (for regression to old version). */
             key?: string;
             /** @description New filename */
@@ -5365,18 +5766,6 @@ type components = {
             cid?: string;
             /** @description New description */
             description?: string;
-            /**
-             * @description Additional properties to merge into the file metadata (e.g., log_data)
-             * @example {
-             *       "log_data": {
-             *         "status": "done",
-             *         "entries": []
-             *       }
-             *     }
-             */
-            extra_properties?: {
-                [key: string]: unknown;
-            };
         };
         ReuploadFileResponse: components["schemas"]["UpdateFileResponse"] & {
             /**
@@ -5424,6 +5813,30 @@ type components = {
             /** @description New description */
             description?: string;
         };
+        ConfirmUploadResponse: components["schemas"]["FileResponse"] & {
+            /**
+             * @description Previous version CID. Not present if upload was already confirmed.
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            prev_cid?: string;
+            /**
+             * @description True if upload was already confirmed. Entity was not modified.
+             * @example false
+             */
+            already_confirmed: boolean;
+        };
+        ConfirmUploadRequest: {
+            /**
+             * @description Current tip CID for CAS validation. Request fails with 409 if this does not match.
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            expect_tip: string;
+            /**
+             * @description Optional note describing this change
+             * @example Added Chapter 42: The Whiteness of the Whale
+             */
+            note?: string;
+        };
         CreateFolderResponse: {
             /**
              * @description Entity ID (ULID format)
@@ -5491,8 +5904,22 @@ type components = {
             metadata?: {
                 [key: string]: unknown;
             };
+            /** @description Additional properties to store */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to create */
+            relationships?: {
+                predicate: string;
+                peer: string;
+                peer_type?: string;
+                peer_label?: string;
+                properties?: {
+                    [key: string]: unknown;
+                };
+            }[];
             /**
-             * @description Collection to add folder to (for permissions)
+             * @description Collection to add folder to (for permissions). Shortcut for adding a collection relationship.
              * @example 01KDETYWYWM0MJVKM8DK3AEXPY
              */
             collection?: string;
@@ -5524,13 +5951,70 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
+            /** @description Properties to add or update (deep merged) */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
+                peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
+                peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
+                properties?: {
+                    [key: string]: unknown;
+                };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
+            }[];
             /** @description New display name */
             label?: string;
             /** @description New description */
             description?: string;
             /** @description New rich description */
             rich_description?: string;
-            /** @description New metadata (replaces existing) */
+            /** @description New metadata (deep merged) */
             metadata?: {
                 [key: string]: unknown;
             };
@@ -5636,7 +6120,7 @@ type components = {
              */
             note?: string;
             /**
-             * @description Children to add
+             * @description Children to add (max 50 per request)
              * @example [
              *       {
              *         "id": "01JFILE123ABCDEFGHJKMNPQRS"
@@ -5672,7 +6156,7 @@ type components = {
              */
             note?: string;
             /**
-             * @description Parent folder ID to add
+             * @description Parent folder or collection ID to add
              * @example 01KDETYWYWM0MJVKM8DK3AEXPY
              */
             parent_id: string;
@@ -5808,12 +6292,6 @@ type components = {
                         [key: string]: unknown;
                     };
                 }[];
-                /** @description IPLD links to components (files, chunks, etc.) */
-                components?: {
-                    [key: string]: {
-                        "/": string;
-                    };
-                };
                 /**
                  * @description Audit trail for edits
                  * @example {
@@ -5952,11 +6430,6 @@ type components = {
              * @example OCR Processor
              */
             label: string;
-            /**
-             * @description Agent description
-             * @example Extracts text from scanned documents using OCR
-             */
-            description?: string;
             /**
              * Format: uri
              * @description Agent service base URL
@@ -5972,6 +6445,13 @@ type components = {
              *     ]
              */
             actions_required: string[];
+            /** @description Collection to place agent in */
+            collection: string;
+            /**
+             * @description Agent description
+             * @example Extracts text from scanned documents using OCR
+             */
+            description?: string;
             /** @description Sub-agents used by this orchestrator */
             uses_agents?: components["schemas"]["SubAgentRef"][];
             /** @description JSON Schema for input validation */
@@ -5982,8 +6462,20 @@ type components = {
             output_schema?: {
                 [key: string]: unknown;
             };
-            /** @description Collection to place agent in */
-            collection: string;
+            /** @description Additional properties to store */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to create */
+            relationships?: {
+                predicate: string;
+                peer: string;
+                peer_type?: string;
+                peer_label?: string;
+                properties?: {
+                    [key: string]: unknown;
+                };
+            }[];
         };
         AgentUpdateResponse: components["schemas"]["AgentResponse"] & {
             /**
@@ -6003,6 +6495,63 @@ type components = {
              * @example Added Chapter 42: The Whiteness of the Whale
              */
             note?: string;
+            /** @description Properties to add or update (deep merged) */
+            properties?: {
+                [key: string]: unknown;
+            };
+            /** @description Properties to remove */
+            properties_remove?: string[] | {
+                [key: string]: unknown;
+            };
+            /** @description Relationships to add or update (upsert semantics) */
+            relationships_add?: {
+                /**
+                 * @description Relationship predicate (e.g., "admin", "contains", "collection")
+                 * @example admin
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer: string;
+                /**
+                 * @description Target entity type hint
+                 * @example user
+                 */
+                peer_type?: string;
+                /**
+                 * @description Target entity label hint
+                 * @example Captain Ahab
+                 */
+                peer_label?: string;
+                /**
+                 * @description Properties to add/update on this relationship (deep merged if relationship exists)
+                 * @example {
+                 *       "expires_at": "2025-12-31T00:00:00Z"
+                 *     }
+                 */
+                properties?: {
+                    [key: string]: unknown;
+                };
+                /** @description Properties to remove from this relationship (string array or nested object) */
+                properties_remove?: string[] | {
+                    [key: string]: unknown;
+                };
+            }[];
+            /** @description Relationships to remove */
+            relationships_remove?: {
+                /**
+                 * @description Relationship predicate
+                 * @example viewer
+                 */
+                predicate: string;
+                /**
+                 * @description Target entity ID. If omitted, removes ALL relationships with this predicate.
+                 * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+                 */
+                peer?: string;
+            }[];
             /** @description Updated agent display name */
             label?: string;
             /** @description Updated agent description */
@@ -6021,6 +6570,12 @@ type components = {
              *     ]
              */
             actions_required?: string[];
+            /**
+             * @description Agent status
+             * @example development
+             * @enum {string}
+             */
+            status?: "development" | "active" | "disabled";
             /** @description Updated sub-agents */
             uses_agents?: components["schemas"]["SubAgentRef"][];
             /** @description Updated input schema */
@@ -6031,12 +6586,6 @@ type components = {
             output_schema?: {
                 [key: string]: unknown;
             };
-            /**
-             * @description Agent status
-             * @example development
-             * @enum {string}
-             */
-            status?: "development" | "active" | "disabled";
         };
         InvokeGrant: {
             agent: {
@@ -6180,6 +6729,61 @@ type components = {
         ListAgentApiKeysResponse: {
             keys: components["schemas"]["AgentApiKeyInfo"][];
         };
+        EventItem: {
+            /**
+             * @description CID of this event in the event chain
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            event_cid: string;
+            /**
+             * @description Type of entity change event
+             * @example create
+             * @enum {string}
+             */
+            type: "create" | "update";
+            /**
+             * @description Entity ID that was created or updated
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            pi: string;
+            /**
+             * @description Entity version number
+             * @example 1
+             */
+            ver: number;
+            /**
+             * @description CID of the entity manifest at this version
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            tip_cid: string;
+            /**
+             * Format: date-time
+             * @description When the event was recorded
+             * @example 2025-12-26T12:00:00.000Z
+             */
+            ts: string;
+        };
+        EventsListResponse: {
+            /** @description Events in reverse chronological order */
+            items: components["schemas"]["EventItem"][];
+            /**
+             * @description Total events in the event chain
+             * @example 1542
+             */
+            total_events: number;
+            /**
+             * @description Total unique entity IDs across all events
+             * @example 987
+             */
+            total_pis: number;
+            /** @description Whether more events exist beyond this page */
+            has_more: boolean;
+            /**
+             * @description CID to use as "cursor" parameter for next page
+             * @example bafyreibug443cnd4endcwinwttw3c3dzmcl2ikht64xzn5qg56bix3usfy
+             */
+            next_cursor: string | null;
+        };
     };
     responses: never;
     parameters: never;