@arke-institute/sdk 3.6.15 → 3.6.16

package/dist/generated/index.d.cts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-03-09T04:14:15.725Z
+ * Generated: 2026-03-13T00:32:55.503Z
  */
 type paths = {
     "/ops-reference": {
@@ -5254,6 +5254,10 @@ type paths = {
          *     - Multiple updates from the same actor are merged before applying (one version)
          *     - Updates from different actors create separate versions (preserves audit trail)
          *
+         *     **Permission Check:**
+         *     - Each target entity is checked for `entity:update` permission before queueing
+         *     - If any entity fails the permission check, the entire batch is rejected
+         *
          *     **Use Cases:**
          *     - Many workers adding relationships to a shared parent entity
          *     - High-volume indexing where multiple sources enrich the same entity
@@ -5326,6 +5330,20 @@ type paths = {
                         "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"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -12980,7 +12998,7 @@ type components = {
             target_entities?: string[];
             /** @description Collection for permission grant. All kladoi in workflow receive temporal permissions on this collection. */
             target_collection: string;
-            /** @description Input data for the workflow */
+            /** @description Optional input data forwarded to every klados in the workflow via request.input. Supports three-level priority merging: (1) flow-level step defaults (lowest), (2) global keys here (middle), (3) per-step overrides via a "steps" key (highest). Example: { "custom_instructions": "global override", "steps": { "describe": { "style": "brief" } } } — global keys apply to all steps, while steps.describe only applies to the "describe" step, overriding both global and flow defaults. */
             input?: {
                 [key: string]: unknown;
             };

package/dist/generated/index.d.ts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-03-09T04:14:15.725Z
+ * Generated: 2026-03-13T00:32:55.503Z
  */
 type paths = {
     "/ops-reference": {
@@ -5254,6 +5254,10 @@ type paths = {
          *     - Multiple updates from the same actor are merged before applying (one version)
          *     - Updates from different actors create separate versions (preserves audit trail)
          *
+         *     **Permission Check:**
+         *     - Each target entity is checked for `entity:update` permission before queueing
+         *     - If any entity fails the permission check, the entire batch is rejected
+         *
          *     **Use Cases:**
          *     - Many workers adding relationships to a shared parent entity
          *     - High-volume indexing where multiple sources enrich the same entity
@@ -5326,6 +5330,20 @@ type paths = {
                         "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"];
+                    };
+                };
             };
         };
         delete?: never;
@@ -12980,7 +12998,7 @@ type components = {
             target_entities?: string[];
             /** @description Collection for permission grant. All kladoi in workflow receive temporal permissions on this collection. */
             target_collection: string;
-            /** @description Input data for the workflow */
+            /** @description Optional input data forwarded to every klados in the workflow via request.input. Supports three-level priority merging: (1) flow-level step defaults (lowest), (2) global keys here (middle), (3) per-step overrides via a "steps" key (highest). Example: { "custom_instructions": "global override", "steps": { "describe": { "style": "brief" } } } — global keys apply to all steps, while steps.describe only applies to the "describe" step, overriding both global and flow defaults. */
             input?: {
                 [key: string]: unknown;
             };

package/openapi/spec.json

@@ -7495,7 +7495,7 @@
             "additionalProperties": {
               "nullable": true
             },
-            "description": "Input data for the workflow"
+            "description": "Optional input data forwarded to every klados in the workflow via request.input. Supports three-level priority merging: (1) flow-level step defaults (lowest), (2) global keys here (middle), (3) per-step overrides via a \"steps\" key (highest). Example: { \"custom_instructions\": \"global override\", \"steps\": { \"describe\": { \"style\": \"brief\" } } } — global keys apply to all steps, while steps.describe only applies to the \"describe\" step, overriding both global and flow defaults."
           },
           "expires_in": {
             "type": "integer",
@@ -14084,7 +14084,7 @@
           "Batch"
         ],
         "summary": "Queue additive updates (fire-and-forget)",
-        "description": "Queues additive updates for multiple entities. Returns 202 Accepted immediately.\n\n**Fire-and-Forget Semantics:**\n- Updates are queued and processed asynchronously\n- CAS conflicts are handled internally with exponential backoff retry\n- Client does not need to retry on conflicts\n\n**Additive-Only Operations:**\n- `properties`: Deep merged with existing properties\n- `relationships_add`: Upsert semantics (add new or merge properties)\n- `properties_remove` and `relationships_remove` are **NOT supported** - use `PUT /entities/:id` for removals\n\n**Per-Actor Versioning:**\n- Multiple updates from the same actor are merged before applying (one version)\n- Updates from different actors create separate versions (preserves audit trail)\n\n**Use Cases:**\n- Many workers adding relationships to a shared parent entity\n- High-volume indexing where multiple sources enrich the same entity\n- Any scenario where ordering doesn't matter and CAS conflicts are expected\n\n**Max batch size:** 100 updates per request.\n\n---\n**Permission:** `entity:update`  \n**Auth:** required",
+        "description": "Queues additive updates for multiple entities. Returns 202 Accepted immediately.\n\n**Fire-and-Forget Semantics:**\n- Updates are queued and processed asynchronously\n- CAS conflicts are handled internally with exponential backoff retry\n- Client does not need to retry on conflicts\n\n**Additive-Only Operations:**\n- `properties`: Deep merged with existing properties\n- `relationships_add`: Upsert semantics (add new or merge properties)\n- `properties_remove` and `relationships_remove` are **NOT supported** - use `PUT /entities/:id` for removals\n\n**Per-Actor Versioning:**\n- Multiple updates from the same actor are merged before applying (one version)\n- Updates from different actors create separate versions (preserves audit trail)\n\n**Permission Check:**\n- Each target entity is checked for `entity:update` permission before queueing\n- If any entity fails the permission check, the entire batch is rejected\n\n**Use Cases:**\n- Many workers adding relationships to a shared parent entity\n- High-volume indexing where multiple sources enrich the same entity\n- Any scenario where ordering doesn't matter and CAS conflicts are expected\n\n**Max batch size:** 100 updates per request.\n\n---\n**Permission:** `entity:update`  \n**Auth:** required",
         "x-arke-action": "entity:update",
         "x-arke-auth": "required",
         "x-arke-tier": "standard",
@@ -14152,6 +14152,19 @@
                 }
               }
             }
+          },
+          "403": {
+            "description": "Forbidden - Insufficient permissions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "example": {
+                  "error": "Forbidden: You do not have permission to perform this action"
+                }
+              }
+            }
           }
         }
       }

package/openapi/version.json

@@ -1,7 +1,7 @@
 {
   "specVersion": "1.0.0",
   "apiVersion": "1.0.0",
-  "fetchedAt": "2026-03-09T04:14:14.826Z",
+  "fetchedAt": "2026-03-13T00:32:54.494Z",
   "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.15",
+  "version": "3.6.16",
   "description": "TypeScript SDK for the Arke API - auto-generated from OpenAPI spec",
   "type": "module",
   "main": "dist/index.cjs",