@arke-institute/sdk 3.6.13 → 3.6.14

package/dist/generated/index.d.cts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-02-16T23:50:23.346Z
+ * Generated: 2026-02-20T03:10:32.965Z
  */
 type paths = {
     "/ops-reference": {
@@ -1037,6 +1037,88 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/collections/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all collections for catalog/sitemap
+         * @description Returns a paginated list of all collection IDs and their last update times.
+         *
+         *     This endpoint is designed for sitemap generation and discovery services. It returns minimal data (just IDs and timestamps) for efficiency.
+         *
+         *     **Lazy Population:** The catalog is populated as collections are created or updated. Newly created collections may take a moment to appear.
+         *
+         *     **No Authentication Required:** This endpoint is public to allow crawlers and discovery services to access it.
+         *
+         *     ---
+         *     **Permission:** `catalog:list`
+         *     **Auth:** none
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Paginated list of collections */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /**
+                                 * @description Collection ID (PI)
+                                 * @example 01JEXAMPLE...
+                                 */
+                                id: string;
+                                /**
+                                 * @description ISO timestamp of last update
+                                 * @example 2026-02-17T12:00:00Z
+                                 */
+                                updated_at: string;
+                            }[];
+                            pagination: {
+                                /** @description Total number of collections in catalog */
+                                total: number;
+                                /** @description Requested limit */
+                                limit: number;
+                                /** @description Current offset */
+                                offset: number;
+                                /** @description Whether more results are available */
+                                has_more: boolean;
+                            };
+                        };
+                    };
+                };
+                /** @description Collections catalog service unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/collections/{id}": {
         parameters: {
             query?: never;
@@ -2194,26 +2276,35 @@ type paths = {
             cookie?: never;
         };
         /**
-         * Search entities by keyword
-         * @description Fast (~5ms) keyword search within entity labels in this collection.
+         * Search entities by keyword or similarity
+         * @description Search within a collection's entities using keyword matching or semantic similarity.
+         *
+         *     **Keyword Search (q parameter):**
+         *     - Fast (~5ms) using per-collection SQLite index
+         *     - Case-insensitive substring match on entity labels
+         *
+         *     **Semantic Similarity Search (similar_to parameter):**
+         *     - Finds entities semantically similar to the given entity ID
+         *     - Uses Pinecone vector similarity
+         *     - Returns results with similarity scores
          *
-         *     Uses a per-collection SQLite index for instant substring matching. Complements semantic search for quick keyword lookups.
+         *     One of `q` or `similar_to` must be provided.
          *
          *     **Query Parameters:**
-         *     - `q`: Search query (required, case-insensitive substring match)
+         *     - `q`: Search query (case-insensitive substring match)
+         *     - `similar_to`: Entity ID to find similar items for
          *     - `type`: Filter by entity type
          *     - `limit`: Maximum results (default: 100, max: 1000)
          *
-         *     **Note:** This is a simple substring match, not semantic search. Use /query for AI-powered semantic search.
-         *
          *     ---
          *     **Permission:** `collection:view`
          *     **Auth:** optional
          */
         get: {
             parameters: {
-                query: {
-                    q: string;
+                query?: {
+                    q?: string;
+                    similar_to?: string;
                     type?: string;
                     limit?: number;
                 };
@@ -3930,7 +4021,7 @@ type paths = {
          *     - Creates a new entity version on each upload
          *
          *     **Storage:**
-         *     Content is stored at `{entity_id}/{key}` in R2, enabling multiple versions per entity.
+         *     Content is stored at `{entity_id}/{cid}` in R2, enabling multiple versions per entity without overwriting.
          *
          *     ---
          *     **Permission:** `entity:update`
@@ -4626,6 +4717,76 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/updates/queue/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get update queue status for entity
+         * @description Returns the status of the additive update queue for a specific entity.
+         *
+         *     **Use Cases:**
+         *     - Diagnose why additive updates may not have been applied
+         *     - Check for pending, processing, or failed updates
+         *     - Monitor queue processing progress
+         *
+         *     **Response includes:**
+         *     - Counts by status (pending, processing, failed)
+         *     - Detailed items with actor, relationships count, error messages, attempts
+         *
+         *
+         *     ---
+         *     **Permission:** `entity:view`
+         *     **Auth:** required
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Queue status retrieved */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QueueStatusResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/updates/additive": {
         parameters: {
             query?: never;
@@ -9698,13 +9859,22 @@ type components = {
             /** @description Number of entities returned */
             count: number;
         };
+        CollectionEntitySearchResult: components["schemas"]["EntityIndexEntry"] & {
+            /**
+             * @description Similarity score (only present for semantic search via similar_to)
+             * @example 0.87
+             */
+            score?: number;
+        };
         CollectionEntitySearchResponse: {
             /** @description Collection ID */
             collection_id: string;
-            /** @description Original search query */
-            query: string;
+            /** @description Original search query (for keyword search) */
+            query?: string;
+            /** @description Source entity ID (for similarity search) */
+            similar_to?: string;
             /** @description Matching entities */
-            entities: components["schemas"]["EntityIndexEntry"][];
+            entities: components["schemas"]["CollectionEntitySearchResult"][];
             /** @description Number of entities returned */
             count: number;
         };
@@ -10604,6 +10774,85 @@ type components = {
              */
             expect_tip: string;
         };
+        QueueItem: {
+            /**
+             * @description Queue item ID
+             * @example 1
+             */
+            id: number;
+            /**
+             * @description Actor who queued the update
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            actor_id: string;
+            /**
+             * @description Current status of the queue item
+             * @example pending
+             * @enum {string}
+             */
+            status: "pending" | "processing" | "failed" | "completed";
+            /**
+             * @description Number of relationships in this update
+             * @example 5
+             */
+            relationships_count: number;
+            /**
+             * @description Summary of relationships (predicate + peer)
+             * @example [
+             *       {
+             *         "predicate": "sent_to",
+             *         "peer": "01KDETYWYWM0MJVKM8DK3AEXPY"
+             *       }
+             *     ]
+             */
+            relationships_summary: {
+                predicate: string;
+                peer: string;
+            }[];
+            /**
+             * @description Top-level property keys being updated
+             * @example [
+             *       "extracted",
+             *       "metadata"
+             *     ]
+             */
+            properties_keys: string[];
+            /**
+             * @description Optional note for the update
+             * @example Extracted by kg-dedupe-resolver
+             */
+            note: string | null;
+            /**
+             * @description Error message if failed
+             * @example CAS conflict after 20 attempts
+             */
+            error: string | null;
+            /**
+             * @description Number of processing attempts
+             * @example 3
+             */
+            attempts: number;
+            /**
+             * @description ISO timestamp when queued
+             * @example 2024-01-15T10:30:00.000Z
+             */
+            queued_at: string;
+        };
+        QueueStatusResponse: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            entity_id: string;
+            /** @description Count of items by status */
+            counts: {
+                pending: number;
+                processing: number;
+                failed: number;
+            };
+            /** @description Detailed queue items (most recent first, max 100) */
+            items: components["schemas"]["QueueItem"][];
+        };
         QueuedUpdateInfo: {
             /**
              * @description Entity ID (ULID format)
@@ -11619,6 +11868,20 @@ type components = {
                             /** @description Target step name if condition matches */
                             target: string;
                         }[];
+                    } | {
+                        /** @description Target step name for bounded recursion */
+                        recurse: string;
+                        /**
+                         * @description Maximum recursion depth (default: 10)
+                         * @example 10
+                         */
+                        max_depth?: number;
+                        /** @description Conditional routing rules */
+                        route?: {
+                            where: components["schemas"]["WhereCondition"];
+                            /** @description Target step name if condition matches */
+                            target: string;
+                        }[];
                     };
                 };
             };
@@ -11807,6 +12070,20 @@ type components = {
                             /** @description Target step name if condition matches */
                             target: string;
                         }[];
+                    } | {
+                        /** @description Target step name for bounded recursion */
+                        recurse: string;
+                        /**
+                         * @description Maximum recursion depth (default: 10)
+                         * @example 10
+                         */
+                        max_depth?: number;
+                        /** @description Conditional routing rules */
+                        route?: {
+                            where: components["schemas"]["WhereCondition"];
+                            /** @description Target step name if condition matches */
+                            target: string;
+                        }[];
                     };
                 };
             };

package/dist/generated/index.d.ts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-02-16T23:50:23.346Z
+ * Generated: 2026-02-20T03:10:32.965Z
  */
 type paths = {
     "/ops-reference": {
@@ -1037,6 +1037,88 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/collections/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List all collections for catalog/sitemap
+         * @description Returns a paginated list of all collection IDs and their last update times.
+         *
+         *     This endpoint is designed for sitemap generation and discovery services. It returns minimal data (just IDs and timestamps) for efficiency.
+         *
+         *     **Lazy Population:** The catalog is populated as collections are created or updated. Newly created collections may take a moment to appear.
+         *
+         *     **No Authentication Required:** This endpoint is public to allow crawlers and discovery services to access it.
+         *
+         *     ---
+         *     **Permission:** `catalog:list`
+         *     **Auth:** none
+         */
+        get: {
+            parameters: {
+                query?: {
+                    limit?: number;
+                    offset?: number | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Paginated list of collections */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            data: {
+                                /**
+                                 * @description Collection ID (PI)
+                                 * @example 01JEXAMPLE...
+                                 */
+                                id: string;
+                                /**
+                                 * @description ISO timestamp of last update
+                                 * @example 2026-02-17T12:00:00Z
+                                 */
+                                updated_at: string;
+                            }[];
+                            pagination: {
+                                /** @description Total number of collections in catalog */
+                                total: number;
+                                /** @description Requested limit */
+                                limit: number;
+                                /** @description Current offset */
+                                offset: number;
+                                /** @description Whether more results are available */
+                                has_more: boolean;
+                            };
+                        };
+                    };
+                };
+                /** @description Collections catalog service unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/collections/{id}": {
         parameters: {
             query?: never;
@@ -2194,26 +2276,35 @@ type paths = {
             cookie?: never;
         };
         /**
-         * Search entities by keyword
-         * @description Fast (~5ms) keyword search within entity labels in this collection.
+         * Search entities by keyword or similarity
+         * @description Search within a collection's entities using keyword matching or semantic similarity.
+         *
+         *     **Keyword Search (q parameter):**
+         *     - Fast (~5ms) using per-collection SQLite index
+         *     - Case-insensitive substring match on entity labels
+         *
+         *     **Semantic Similarity Search (similar_to parameter):**
+         *     - Finds entities semantically similar to the given entity ID
+         *     - Uses Pinecone vector similarity
+         *     - Returns results with similarity scores
          *
-         *     Uses a per-collection SQLite index for instant substring matching. Complements semantic search for quick keyword lookups.
+         *     One of `q` or `similar_to` must be provided.
          *
          *     **Query Parameters:**
-         *     - `q`: Search query (required, case-insensitive substring match)
+         *     - `q`: Search query (case-insensitive substring match)
+         *     - `similar_to`: Entity ID to find similar items for
          *     - `type`: Filter by entity type
          *     - `limit`: Maximum results (default: 100, max: 1000)
          *
-         *     **Note:** This is a simple substring match, not semantic search. Use /query for AI-powered semantic search.
-         *
          *     ---
          *     **Permission:** `collection:view`
          *     **Auth:** optional
          */
         get: {
             parameters: {
-                query: {
-                    q: string;
+                query?: {
+                    q?: string;
+                    similar_to?: string;
                     type?: string;
                     limit?: number;
                 };
@@ -3930,7 +4021,7 @@ type paths = {
          *     - Creates a new entity version on each upload
          *
          *     **Storage:**
-         *     Content is stored at `{entity_id}/{key}` in R2, enabling multiple versions per entity.
+         *     Content is stored at `{entity_id}/{cid}` in R2, enabling multiple versions per entity without overwriting.
          *
          *     ---
          *     **Permission:** `entity:update`
@@ -4626,6 +4717,76 @@ type paths = {
         patch?: never;
         trace?: never;
     };
+    "/updates/queue/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get update queue status for entity
+         * @description Returns the status of the additive update queue for a specific entity.
+         *
+         *     **Use Cases:**
+         *     - Diagnose why additive updates may not have been applied
+         *     - Check for pending, processing, or failed updates
+         *     - Monitor queue processing progress
+         *
+         *     **Response includes:**
+         *     - Counts by status (pending, processing, failed)
+         *     - Detailed items with actor, relationships count, error messages, attempts
+         *
+         *
+         *     ---
+         *     **Permission:** `entity:view`
+         *     **Auth:** required
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Entity ID (ULID) */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Queue status retrieved */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["QueueStatusResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/updates/additive": {
         parameters: {
             query?: never;
@@ -9698,13 +9859,22 @@ type components = {
             /** @description Number of entities returned */
             count: number;
         };
+        CollectionEntitySearchResult: components["schemas"]["EntityIndexEntry"] & {
+            /**
+             * @description Similarity score (only present for semantic search via similar_to)
+             * @example 0.87
+             */
+            score?: number;
+        };
         CollectionEntitySearchResponse: {
             /** @description Collection ID */
             collection_id: string;
-            /** @description Original search query */
-            query: string;
+            /** @description Original search query (for keyword search) */
+            query?: string;
+            /** @description Source entity ID (for similarity search) */
+            similar_to?: string;
             /** @description Matching entities */
-            entities: components["schemas"]["EntityIndexEntry"][];
+            entities: components["schemas"]["CollectionEntitySearchResult"][];
             /** @description Number of entities returned */
             count: number;
         };
@@ -10604,6 +10774,85 @@ type components = {
              */
             expect_tip: string;
         };
+        QueueItem: {
+            /**
+             * @description Queue item ID
+             * @example 1
+             */
+            id: number;
+            /**
+             * @description Actor who queued the update
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            actor_id: string;
+            /**
+             * @description Current status of the queue item
+             * @example pending
+             * @enum {string}
+             */
+            status: "pending" | "processing" | "failed" | "completed";
+            /**
+             * @description Number of relationships in this update
+             * @example 5
+             */
+            relationships_count: number;
+            /**
+             * @description Summary of relationships (predicate + peer)
+             * @example [
+             *       {
+             *         "predicate": "sent_to",
+             *         "peer": "01KDETYWYWM0MJVKM8DK3AEXPY"
+             *       }
+             *     ]
+             */
+            relationships_summary: {
+                predicate: string;
+                peer: string;
+            }[];
+            /**
+             * @description Top-level property keys being updated
+             * @example [
+             *       "extracted",
+             *       "metadata"
+             *     ]
+             */
+            properties_keys: string[];
+            /**
+             * @description Optional note for the update
+             * @example Extracted by kg-dedupe-resolver
+             */
+            note: string | null;
+            /**
+             * @description Error message if failed
+             * @example CAS conflict after 20 attempts
+             */
+            error: string | null;
+            /**
+             * @description Number of processing attempts
+             * @example 3
+             */
+            attempts: number;
+            /**
+             * @description ISO timestamp when queued
+             * @example 2024-01-15T10:30:00.000Z
+             */
+            queued_at: string;
+        };
+        QueueStatusResponse: {
+            /**
+             * @description Entity ID (ULID format)
+             * @example 01KDETYWYWM0MJVKM8DK3AEXPY
+             */
+            entity_id: string;
+            /** @description Count of items by status */
+            counts: {
+                pending: number;
+                processing: number;
+                failed: number;
+            };
+            /** @description Detailed queue items (most recent first, max 100) */
+            items: components["schemas"]["QueueItem"][];
+        };
         QueuedUpdateInfo: {
             /**
              * @description Entity ID (ULID format)
@@ -11619,6 +11868,20 @@ type components = {
                             /** @description Target step name if condition matches */
                             target: string;
                         }[];
+                    } | {
+                        /** @description Target step name for bounded recursion */
+                        recurse: string;
+                        /**
+                         * @description Maximum recursion depth (default: 10)
+                         * @example 10
+                         */
+                        max_depth?: number;
+                        /** @description Conditional routing rules */
+                        route?: {
+                            where: components["schemas"]["WhereCondition"];
+                            /** @description Target step name if condition matches */
+                            target: string;
+                        }[];
                     };
                 };
             };
@@ -11807,6 +12070,20 @@ type components = {
                             /** @description Target step name if condition matches */
                             target: string;
                         }[];
+                    } | {
+                        /** @description Target step name for bounded recursion */
+                        recurse: string;
+                        /**
+                         * @description Maximum recursion depth (default: 10)
+                         * @example 10
+                         */
+                        max_depth?: number;
+                        /** @description Conditional routing rules */
+                        route?: {
+                            where: components["schemas"]["WhereCondition"];
+                            /** @description Target step name if condition matches */
+                            target: string;
+                        }[];
                     };
                 };
             };

package/openapi/spec.json

@@ -1023,7 +1023,7 @@
           "query": {
             "type": "string",
             "minLength": 1,
-            "maxLength": 500,
+            "maxLength": 10000,
             "description": "Search query text for semantic matching",
             "example": "medical research"
           },
@@ -1995,6 +1995,23 @@
           "count"
         ]
       },
+      "CollectionEntitySearchResult": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/EntityIndexEntry"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "score": {
+                "type": "number",
+                "description": "Similarity score (only present for semantic search via similar_to)",
+                "example": 0.87
+              }
+            }
+          }
+        ]
+      },
       "CollectionEntitySearchResponse": {
         "type": "object",
         "properties": {
@@ -2005,12 +2022,17 @@
           },
           "query": {
             "type": "string",
-            "description": "Original search query"
+            "description": "Original search query (for keyword search)"
+          },
+          "similar_to": {
+            "type": "string",
+            "pattern": "^(?:II[0-9A-HJKMNP-TV-Z]{24}|[FC][0-9A-HJKMNP-TV-Z]{25}|[0-9A-HJKMNP-TV-Z]{26})$",
+            "description": "Source entity ID (for similarity search)"
           },
           "entities": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/EntityIndexEntry"
+              "$ref": "#/components/schemas/CollectionEntitySearchResult"
             },
             "description": "Matching entities"
           },
@@ -2021,7 +2043,6 @@
         },
         "required": [
           "collection_id",
-          "query",
           "entities",
           "count"
         ]
@@ -3852,6 +3873,150 @@
           "expect_tip"
         ]
       },
+      "QueueItem": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Queue item ID",
+            "example": 1
+          },
+          "actor_id": {
+            "type": "string",
+            "description": "Actor who queued the update",
+            "example": "01KDETYWYWM0MJVKM8DK3AEXPY"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "processing",
+              "failed",
+              "completed"
+            ],
+            "description": "Current status of the queue item",
+            "example": "pending"
+          },
+          "relationships_count": {
+            "type": "integer",
+            "description": "Number of relationships in this update",
+            "example": 5
+          },
+          "relationships_summary": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "predicate": {
+                  "type": "string"
+                },
+                "peer": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "predicate",
+                "peer"
+              ]
+            },
+            "description": "Summary of relationships (predicate + peer)",
+            "example": [
+              {
+                "predicate": "sent_to",
+                "peer": "01KDETYWYWM0MJVKM8DK3AEXPY"
+              }
+            ]
+          },
+          "properties_keys": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Top-level property keys being updated",
+            "example": [
+              "extracted",
+              "metadata"
+            ]
+          },
+          "note": {
+            "type": "string",
+            "nullable": true,
+            "description": "Optional note for the update",
+            "example": "Extracted by kg-dedupe-resolver"
+          },
+          "error": {
+            "type": "string",
+            "nullable": true,
+            "description": "Error message if failed",
+            "example": "CAS conflict after 20 attempts"
+          },
+          "attempts": {
+            "type": "integer",
+            "description": "Number of processing attempts",
+            "example": 3
+          },
+          "queued_at": {
+            "type": "string",
+            "description": "ISO timestamp when queued",
+            "example": "2024-01-15T10:30:00.000Z"
+          }
+        },
+        "required": [
+          "id",
+          "actor_id",
+          "status",
+          "relationships_count",
+          "relationships_summary",
+          "properties_keys",
+          "note",
+          "error",
+          "attempts",
+          "queued_at"
+        ]
+      },
+      "QueueStatusResponse": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "type": "string",
+            "pattern": "^(?:II[0-9A-HJKMNP-TV-Z]{24}|[FC][0-9A-HJKMNP-TV-Z]{25}|[0-9A-HJKMNP-TV-Z]{26})$",
+            "description": "Entity ID (ULID format)",
+            "example": "01KDETYWYWM0MJVKM8DK3AEXPY"
+          },
+          "counts": {
+            "type": "object",
+            "properties": {
+              "pending": {
+                "type": "integer"
+              },
+              "processing": {
+                "type": "integer"
+              },
+              "failed": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "pending",
+              "processing",
+              "failed"
+            ],
+            "description": "Count of items by status"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/QueueItem"
+            },
+            "description": "Detailed queue items (most recent first, max 100)"
+          }
+        },
+        "required": [
+          "entity_id",
+          "counts",
+          "items"
+        ]
+      },
       "QueuedUpdateInfo": {
         "type": "object",
         "properties": {
@@ -5960,6 +6125,48 @@
                       "required": [
                         "gather"
                       ]
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "recurse": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Target step name for bounded recursion"
+                        },
+                        "max_depth": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "Maximum recursion depth (default: 10)",
+                          "example": 10
+                        },
+                        "route": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "where": {
+                                "$ref": "#/components/schemas/WhereCondition"
+                              },
+                              "target": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Target step name if condition matches"
+                              }
+                            },
+                            "required": [
+                              "where",
+                              "target"
+                            ],
+                            "description": "Conditional routing rule. First matching rule wins.",
+                            "title": "RouteRule"
+                          },
+                          "description": "Conditional routing rules"
+                        }
+                      },
+                      "required": [
+                        "recurse"
+                      ]
                     }
                   ],
                   "description": "What happens after this klados completes",
@@ -6427,6 +6634,48 @@
                       "required": [
                         "gather"
                       ]
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "recurse": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Target step name for bounded recursion"
+                        },
+                        "max_depth": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "Maximum recursion depth (default: 10)",
+                          "example": 10
+                        },
+                        "route": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "where": {
+                                "$ref": "#/components/schemas/WhereCondition"
+                              },
+                              "target": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Target step name if condition matches"
+                              }
+                            },
+                            "required": [
+                              "where",
+                              "target"
+                            ],
+                            "description": "Conditional routing rule. First matching rule wins.",
+                            "title": "RouteRule"
+                          },
+                          "description": "Conditional routing rules"
+                        }
+                      },
+                      "required": [
+                        "recurse"
+                      ]
                     }
                   ],
                   "description": "What happens after this klados completes",
@@ -9277,6 +9526,116 @@
         }
       }
     },
+    "/collections/catalog": {
+      "get": {
+        "tags": [
+          "Collections"
+        ],
+        "summary": "List all collections for catalog/sitemap",
+        "description": "Returns a paginated list of all collection IDs and their last update times.\n\nThis endpoint is designed for sitemap generation and discovery services. It returns minimal data (just IDs and timestamps) for efficiency.\n\n**Lazy Population:** The catalog is populated as collections are created or updated. Newly created collections may take a moment to appear.\n\n**No Authentication Required:** This endpoint is public to allow crawlers and discovery services to access it.\n\n---\n**Permission:** `catalog:list`  \n**Auth:** none",
+        "x-arke-action": "catalog:list",
+        "x-arke-auth": "none",
+        "x-arke-tier": "standard",
+        "parameters": [
+          {
+            "schema": {
+              "type": "number",
+              "minimum": 1,
+              "maximum": 1000,
+              "default": 100,
+              "description": "Maximum number of collections to return (1-1000)",
+              "example": 100
+            },
+            "required": false,
+            "name": "limit",
+            "in": "query"
+          },
+          {
+            "schema": {
+              "type": "number",
+              "nullable": true,
+              "minimum": 0,
+              "default": 0,
+              "description": "Number of collections to skip for pagination",
+              "example": 0
+            },
+            "required": false,
+            "name": "offset",
+            "in": "query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated list of collections",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "Collection ID (PI)",
+                            "example": "01JEXAMPLE..."
+                          },
+                          "updated_at": {
+                            "type": "string",
+                            "description": "ISO timestamp of last update",
+                            "example": "2026-02-17T12:00:00Z"
+                          }
+                        },
+                        "required": [
+                          "id",
+                          "updated_at"
+                        ]
+                      }
+                    },
+                    "pagination": {
+                      "type": "object",
+                      "properties": {
+                        "total": {
+                          "type": "number",
+                          "description": "Total number of collections in catalog"
+                        },
+                        "limit": {
+                          "type": "number",
+                          "description": "Requested limit"
+                        },
+                        "offset": {
+                          "type": "number",
+                          "description": "Current offset"
+                        },
+                        "has_more": {
+                          "type": "boolean",
+                          "description": "Whether more results are available"
+                        }
+                      },
+                      "required": [
+                        "total",
+                        "limit",
+                        "offset",
+                        "has_more"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data",
+                    "pagination"
+                  ]
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Collections catalog service unavailable"
+          }
+        }
+      }
+    },
     "/collections/{id}": {
       "get": {
         "tags": [
@@ -10328,8 +10687,8 @@
           {
             "schema": {
               "type": "string",
-              "description": "JSON-encoded filter for custom properties (underscore-prefixed). Supports direct equality {\"_year\": 1850} or operators {\"_year\": {\"$gte\": 1800}}. Operators: $eq, $ne, $gt, $gte, $lt, $lte.",
-              "example": "{\"_year\":{\"$gte\":1800,\"$lte\":1900}}"
+              "description": "JSON-encoded string for filtering by custom properties. Only underscore-prefixed properties (e.g., _year, _kg_layer) are filterable. Pass as URL-encoded JSON: ?filter={\"_kg_layer\":0}. Supports direct equality {\"_year\": 1850} or comparison operators {\"_year\": {\"$gte\": 1800, \"$lte\": 1900}}. Available operators: $eq, $ne, $gt, $gte, $lt, $lte. Multiple properties are AND-combined.",
+              "example": "{\"_kg_layer\":0}"
             },
             "required": false,
             "name": "filter",
@@ -10524,8 +10883,8 @@
         "tags": [
           "Collections"
         ],
-        "summary": "Search entities by keyword",
-        "description": "Fast (~5ms) keyword search within entity labels in this collection.\n\nUses a per-collection SQLite index for instant substring matching. Complements semantic search for quick keyword lookups.\n\n**Query Parameters:**\n- `q`: Search query (required, case-insensitive substring match)\n- `type`: Filter by entity type\n- `limit`: Maximum results (default: 100, max: 1000)\n\n**Note:** This is a simple substring match, not semantic search. Use /query for AI-powered semantic search.\n\n---\n**Permission:** `collection:view`  \n**Auth:** optional",
+        "summary": "Search entities by keyword or similarity",
+        "description": "Search within a collection's entities using keyword matching or semantic similarity.\n\n**Keyword Search (q parameter):**\n- Fast (~5ms) using per-collection SQLite index\n- Case-insensitive substring match on entity labels\n\n**Semantic Similarity Search (similar_to parameter):**\n- Finds entities semantically similar to the given entity ID\n- Uses Pinecone vector similarity\n- Returns results with similarity scores\n\nOne of `q` or `similar_to` must be provided.\n\n**Query Parameters:**\n- `q`: Search query (case-insensitive substring match)\n- `similar_to`: Entity ID to find similar items for\n- `type`: Filter by entity type\n- `limit`: Maximum results (default: 100, max: 1000)\n\n---\n**Permission:** `collection:view`  \n**Auth:** optional",
         "x-arke-action": "collection:view",
         "x-arke-auth": "optional",
         "x-arke-tier": "standard",
@@ -10546,13 +10905,24 @@
             "schema": {
               "type": "string",
               "minLength": 1,
-              "description": "Search query (case-insensitive substring match on label)",
+              "description": "Search query (case-insensitive substring match on label). Required if similar_to is not provided.",
               "example": "ahab"
             },
-            "required": true,
+            "required": false,
             "name": "q",
             "in": "query"
           },
+          {
+            "schema": {
+              "type": "string",
+              "pattern": "^(?:II[0-9A-HJKMNP-TV-Z]{24}|[FC][0-9A-HJKMNP-TV-Z]{25}|[0-9A-HJKMNP-TV-Z]{26})$",
+              "description": "Entity ID to find semantically similar items. Uses vector similarity instead of keyword search. Required if q is not provided.",
+              "example": "01JQ3EQ3EG000000000000000"
+            },
+            "required": false,
+            "name": "similar_to",
+            "in": "query"
+          },
           {
             "schema": {
               "type": "string",
@@ -12071,7 +12441,7 @@
           "Entities"
         ],
         "summary": "Upload content for any entity",
-        "description": "Uploads binary content for any entity type. Any entity can have content attached.\n\n**Request:**\n- Query param `key` (required): Version key for this content (e.g., \"v1\", \"original\", \"thumbnail\")\n- Query param `filename` (optional): Filename for Content-Disposition header on download\n- Header `Content-Type`: MIME type of the content (required)\n- Header `Content-Length`: Size for pre-upload validation (optional, max 500MB)\n- Body: Binary content (streaming supported)\n\n**Behavior:**\n- Streams content directly to R2 storage\n- Computes CID from content bytes\n- Updates entity with `properties.content` metadata\n- Re-uploading with same key overwrites the content\n- Creates a new entity version on each upload\n\n**Storage:**\nContent is stored at `{entity_id}/{key}` in R2, enabling multiple versions per entity.\n\n---\n**Permission:** `entity:update`  \n**Auth:** required",
+        "description": "Uploads binary content for any entity type. Any entity can have content attached.\n\n**Request:**\n- Query param `key` (required): Version key for this content (e.g., \"v1\", \"original\", \"thumbnail\")\n- Query param `filename` (optional): Filename for Content-Disposition header on download\n- Header `Content-Type`: MIME type of the content (required)\n- Header `Content-Length`: Size for pre-upload validation (optional, max 500MB)\n- Body: Binary content (streaming supported)\n\n**Behavior:**\n- Streams content directly to R2 storage\n- Computes CID from content bytes\n- Updates entity with `properties.content` metadata\n- Re-uploading with same key overwrites the content\n- Creates a new entity version on each upload\n\n**Storage:**\nContent is stored at `{entity_id}/{cid}` in R2, enabling multiple versions per entity without overwriting.\n\n---\n**Permission:** `entity:update`  \n**Auth:** required",
         "x-arke-action": "entity:update",
         "x-arke-auth": "required",
         "x-arke-tier": "standard",
@@ -12849,6 +13219,66 @@
         }
       }
     },
+    "/updates/queue/{id}": {
+      "get": {
+        "tags": [
+          "Entities",
+          "Diagnostics"
+        ],
+        "summary": "Get update queue status for entity",
+        "description": "Returns the status of the additive update queue for a specific entity.\n\n**Use Cases:**\n- Diagnose why additive updates may not have been applied\n- Check for pending, processing, or failed updates\n- Monitor queue processing progress\n\n**Response includes:**\n- Counts by status (pending, processing, failed)\n- Detailed items with actor, relationships count, error messages, attempts\n\n\n---\n**Permission:** `entity:view`  \n**Auth:** required",
+        "x-arke-action": "entity:view",
+        "x-arke-auth": "required",
+        "x-arke-tier": "standard",
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "schema": {
+              "type": "string",
+              "pattern": "^(?:II[0-9A-HJKMNP-TV-Z]{24}|[FC][0-9A-HJKMNP-TV-Z]{25}|[0-9A-HJKMNP-TV-Z]{26})$",
+              "description": "Entity ID (ULID format)",
+              "example": "01KDETYWYWM0MJVKM8DK3AEXPY"
+            },
+            "required": true,
+            "description": "Entity ID (ULID)",
+            "name": "id",
+            "in": "path"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Queue status retrieved",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/QueueStatusResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - Missing or invalid authentication",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "example": {
+                  "error": "Unauthorized: Missing or invalid authentication token"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/updates/additive": {
       "post": {
         "tags": [
@@ -15568,7 +15998,7 @@
                   "query": {
                     "type": "string",
                     "minLength": 1,
-                    "maxLength": 500,
+                    "maxLength": 10000,
                     "description": "Search query text"
                   },
                   "limit": {
@@ -15778,7 +16208,7 @@
                   "query": {
                     "type": "string",
                     "minLength": 1,
-                    "maxLength": 500,
+                    "maxLength": 10000,
                     "description": "Search query text"
                   },
                   "limit": {
@@ -16007,7 +16437,7 @@
                   "query": {
                     "type": "string",
                     "minLength": 1,
-                    "maxLength": 500,
+                    "maxLength": 10000,
                     "description": "Search query text"
                   },
                   "limit": {
@@ -16239,7 +16669,7 @@
                   "query": {
                     "type": "string",
                     "minLength": 1,
-                    "maxLength": 500,
+                    "maxLength": 10000,
                     "description": "Search query text"
                   },
                   "limit": {

package/openapi/version.json

@@ -1,7 +1,7 @@
 {
   "specVersion": "1.0.0",
   "apiVersion": "1.0.0",
-  "fetchedAt": "2026-02-16T23:01:39.884Z",
+  "fetchedAt": "2026-02-20T03:10:32.012Z",
   "sourceUrl": "https://api.arke.institute/openapi.json",
   "openApiVersion": "3.1.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arke-institute/sdk",
-  "version": "3.6.13",
+  "version": "3.6.14",
   "description": "TypeScript SDK for the Arke API - auto-generated from OpenAPI spec",
   "type": "module",
   "main": "dist/index.cjs",