@arke-institute/sdk 3.6.4 → 3.6.6

package/dist/generated/index.d.cts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-02-11T22:34:10.645Z
+ * Generated: 2026-02-13T15:33:39.556Z
  */
 type paths = {
     "/ops-reference": {
@@ -931,6 +931,25 @@ type paths = {
          * Create a new collection
          * @description Creates a collection with the authenticated user as owner.
          *
+         *     **Default Roles:**
+         *
+         *     By default (`use_roles_default: true`), collections include these standard roles:
+         *     - `owner`: Full control including collection management
+         *     - `editor`: Can modify entities but not collection settings
+         *     - `viewer`: Read-only access
+         *     - `public`: Public read access (`*:view`)
+         *
+         *     **Customizing Roles:**
+         *
+         *     Pass custom `roles` to override specific defaults while keeping others. For example, to make entities publicly invokable (for agents):
+         *     ```json
+         *     { "roles": { "public": ["*:view", "*:invoke"] } }
+         *     ```
+         *
+         *     Set `use_roles_default: false` to define all roles from scratch.
+         *
+         *     **Platform Requirement:** The `public` role with `*:view` is always automatically ensured, guaranteeing all collections are publicly readable.
+         *
          *     ---
          *     **Permission:** `collection:create`
          *     **Auth:** required
@@ -1981,13 +2000,13 @@ type paths = {
         };
         /**
          * List entities in a collection
-         * @description Returns entities belonging to this collection from the graph database.
+         * @description Returns entities belonging to this collection.
          *
          *     Supports pagination and optional type filtering. Results are ordered by creation date (newest first).
          *
          *     **Expansion Modes:**
          *
-         *     By default, returns lightweight summaries from GraphDB (pi, type, label, timestamps).
+         *     By default, returns lightweight summaries (pi, type, label, timestamps).
          *
          *     Use the `expand` parameter to hydrate entity data from storage:
          *
@@ -2055,7 +2074,7 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description GraphDB service unavailable */
+                /** @description Collection index service unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -9068,26 +9087,17 @@ type components = {
              */
             display_image_url?: string;
             /**
-             * @description Custom role definitions (defaults to owner/editor/viewer/public)
+             * @description Whether to merge with default roles (true) or use only provided roles (false). Public role with *:view is always ensured.
+             * @default true
+             * @example true
+             */
+            use_roles_default: boolean;
+            /**
+             * @description Role definitions. When use_roles_default is true (default), these merge with defaults. When false, these replace defaults entirely.
              * @example {
-             *       "captain": [
-             *         "*:view",
-             *         "*:update",
-             *         "*:create",
-             *         "collection:manage"
-             *       ],
-             *       "harpooner": [
-             *         "*:view",
-             *         "*:update",
-             *         "*:create"
-             *       ],
-             *       "crew": [
-             *         "*:view",
-             *         "entity:create"
-             *       ],
              *       "public": [
-             *         "entity:view",
-             *         "collection:view"
+             *         "*:view",
+             *         "*:invoke"
              *       ]
              *     }
              */
@@ -9616,6 +9626,11 @@ type components = {
              * @example 01KDETYWYWM0MJVKM8DK3AEXPY
              */
             collection?: string;
+            /**
+             * @description Wait for collection index update before returning. Use when checking for duplicates immediately after creation. Adds ~1-5ms latency per collection.
+             * @default false
+             */
+            sync_index: boolean;
         };
         BatchCreateSuccess: {
             /** @enum {boolean} */

package/dist/generated/index.d.ts

@@ -6,7 +6,7 @@
  *
  * Source: Arke v1 API
  * Version: 1.0.0
- * Generated: 2026-02-11T22:34:10.645Z
+ * Generated: 2026-02-13T15:33:39.556Z
  */
 type paths = {
     "/ops-reference": {
@@ -931,6 +931,25 @@ type paths = {
          * Create a new collection
          * @description Creates a collection with the authenticated user as owner.
          *
+         *     **Default Roles:**
+         *
+         *     By default (`use_roles_default: true`), collections include these standard roles:
+         *     - `owner`: Full control including collection management
+         *     - `editor`: Can modify entities but not collection settings
+         *     - `viewer`: Read-only access
+         *     - `public`: Public read access (`*:view`)
+         *
+         *     **Customizing Roles:**
+         *
+         *     Pass custom `roles` to override specific defaults while keeping others. For example, to make entities publicly invokable (for agents):
+         *     ```json
+         *     { "roles": { "public": ["*:view", "*:invoke"] } }
+         *     ```
+         *
+         *     Set `use_roles_default: false` to define all roles from scratch.
+         *
+         *     **Platform Requirement:** The `public` role with `*:view` is always automatically ensured, guaranteeing all collections are publicly readable.
+         *
          *     ---
          *     **Permission:** `collection:create`
          *     **Auth:** required
@@ -1981,13 +2000,13 @@ type paths = {
         };
         /**
          * List entities in a collection
-         * @description Returns entities belonging to this collection from the graph database.
+         * @description Returns entities belonging to this collection.
          *
          *     Supports pagination and optional type filtering. Results are ordered by creation date (newest first).
          *
          *     **Expansion Modes:**
          *
-         *     By default, returns lightweight summaries from GraphDB (pi, type, label, timestamps).
+         *     By default, returns lightweight summaries (pi, type, label, timestamps).
          *
          *     Use the `expand` parameter to hydrate entity data from storage:
          *
@@ -2055,7 +2074,7 @@ type paths = {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description GraphDB service unavailable */
+                /** @description Collection index service unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -9068,26 +9087,17 @@ type components = {
              */
             display_image_url?: string;
             /**
-             * @description Custom role definitions (defaults to owner/editor/viewer/public)
+             * @description Whether to merge with default roles (true) or use only provided roles (false). Public role with *:view is always ensured.
+             * @default true
+             * @example true
+             */
+            use_roles_default: boolean;
+            /**
+             * @description Role definitions. When use_roles_default is true (default), these merge with defaults. When false, these replace defaults entirely.
              * @example {
-             *       "captain": [
-             *         "*:view",
-             *         "*:update",
-             *         "*:create",
-             *         "collection:manage"
-             *       ],
-             *       "harpooner": [
-             *         "*:view",
-             *         "*:update",
-             *         "*:create"
-             *       ],
-             *       "crew": [
-             *         "*:view",
-             *         "entity:create"
-             *       ],
              *       "public": [
-             *         "entity:view",
-             *         "collection:view"
+             *         "*:view",
+             *         "*:invoke"
              *       ]
              *     }
              */
@@ -9616,6 +9626,11 @@ type components = {
              * @example 01KDETYWYWM0MJVKM8DK3AEXPY
              */
             collection?: string;
+            /**
+             * @description Wait for collection index update before returning. Use when checking for duplicates immediately after creation. Adds ~1-5ms latency per collection.
+             * @default false
+             */
+            sync_index: boolean;
         };
         BatchCreateSuccess: {
             /** @enum {boolean} */