@granular-software/sdk 0.4.28 → 0.4.30

package/dist/cli/index.js

@@ -14230,17 +14230,8 @@ var searchableMetamodelPackage = defineMetamodelPackage({
     }
   },
   domain: {
-    applyToPropertyIR(propertyIR, propertySummary) {
-      if (String(propertySummary.type || "").toLowerCase() !== "string" || propertySummary.searchable === false) {
-        return propertyIR;
-      }
-      return {
-        ...propertyIR,
-        docs: [
-          ...propertyIR.docs,
-          propertySummary.searchablePhonetic ? "Searchable via `search` using FalkorDB full-text query syntax with phonetic matching enabled." : "Searchable via `search` using FalkorDB full-text query syntax."
-        ]
-      };
+    applyToPropertyIR(propertyIR, _propertySummary) {
+      return propertyIR;
     }
   }
 });
@@ -15038,6 +15029,8 @@ Runtime note: class-wide \`search\` is implemented as one denormalized full-text
 Preferred search ladder: start with plain text such as \`find({ search: "example name" })\`. If results are empty or ambiguous, retry with RediSearch-style fuzzy / prefix / OR operators. Add \`filter\` only when you need exact structural narrowing.
 Plain string \`search\` is normalized for human text before it reaches full-text search, so case, punctuation, repeated whitespace, and diacritics do not need to be manually enumerated in agent code.
 Do not manually enumerate capitalization / punctuation / spacing variants in agent code. Use plain \`search\` first, then escalate to fuzzy / prefix / OR operators only if the first pass is empty or ambiguous.
+Sorting is first-class too: use generated runtime syntax like \`page({ perPage: 10, sort: { field: "year", order: "asc" } })\` or GraphQL syntax like \`direct_instances(per_page: 10, sort: { at: "year", order: ASC })\` when result order matters.
+Sorting is applied in FalkorDB before pagination and limit selection. Do not load a page and sort it afterward in agent code.
 Optional indexing note: \`"searchable": { "phonetic": true }\` keeps the field searchable and enables FalkorDB phonetic matching for the class-wide search index. Query syntax does not change; agents should keep using normal \`search\` strings.
 Without an explicit sort, indexed \`search\` results are returned in FalkorDB relevance order. If you pass a sort, that explicit sort takes precedence.
 
@@ -19518,17 +19511,40 @@ function buildEffectMetamodelMutations(toolPath, spec) {
 
 // src/client.ts
 var STANDARD_MODULES_OPERATIONS = [
-  { create: "entity", has: { id: { value: "auto-generated" }, createdAt: { value: void 0 } } },
+  {
+    create: "entity",
+    has: { id: { value: "auto-generated" }, createdAt: { value: void 0 } }
+  },
   { create: "class", extends: "entity", has: {} },
-  { create: "user", extends: "entity", has: { email: { value: void 0 }, firstName: { value: void 0 }, lastName: { value: void 0 } } },
-  { create: "company", extends: "entity", has: { name: { value: void 0 }, website: { value: void 0 } } },
+  {
+    create: "user",
+    extends: "entity",
+    has: {
+      email: { value: void 0 },
+      firstName: { value: void 0 },
+      lastName: { value: void 0 }
+    }
+  },
+  {
+    create: "company",
+    extends: "entity",
+    has: { name: { value: void 0 }, website: { value: void 0 } }
+  },
   { create: "string", has: {} },
   { create: "number", has: {} },
   { create: "boolean", has: {} },
-  { create: "tool_parameter", has: { name: { value: void 0 }, type: { value: "string" }, description: { value: void 0 }, required: { value: false } } }
+  {
+    create: "tool_parameter",
+    has: {
+      name: { value: void 0 },
+      type: { value: "string" },
+      description: { value: void 0 },
+      required: { value: false }
+    }
+  }
 ];
 var BUILTIN_MODULES = {
-  "standard_modules": STANDARD_MODULES_OPERATIONS
+  standard_modules: STANDARD_MODULES_OPERATIONS
 };
 var DEFAULT_DIRECT_RECORD_OBJECTS_REQUEST_BATCH_SIZE = 100;
 var MAX_RECORD_OBJECTS_CONCURRENCY = 16;
@@ -19563,7 +19579,9 @@ function isRetryableLocalWorkerRestart(status, body, url) {
 }
 function isRetryableRecordObjectsError(error2) {
   const message = error2 instanceof Error ? error2.message : String(error2);
-  return /worker restarted mid-request|econnreset|network|socket connection was closed unexpectedly|timed out/i.test(message);
+  return /worker restarted mid-request|econnreset|network|socket connection was closed unexpectedly|timed out/i.test(
+    message
+  );
 }
 function computeEffectKey2(effect) {
   const attachedClass = effect.className?.trim();
@@ -19640,7 +19658,10 @@ function normalizeUser(user) {
   };
 }
 function normalizeEnvironmentData(environment) {
-  const buildPolicy = environment.buildPolicy || environment.tracking || (environment.tagId ? { mode: "tag", tagId: environment.tagId } : { mode: "pinned", versionId: environment.versionId || environment.buildId });
+  const buildPolicy = environment.buildPolicy || environment.tracking || (environment.tagId ? { mode: "tag", tagId: environment.tagId } : {
+    mode: "pinned",
+    versionId: environment.versionId || environment.buildId
+  });
   const environmentName = environment.environment || environment.envName || "prod";
   return {
     ...environment,
@@ -19734,14 +19755,16 @@ var Environment = class extends Session {
     const response = await fetch(url, {
       ...options,
       headers: {
-        "Authorization": `Bearer ${this._apiKey}`,
+        Authorization: `Bearer ${this._apiKey}`,
         "Content-Type": "application/json",
-        "Connection": "close",
+        Connection: "close",
         ...options.headers
       }
     });
     if (!response.ok) {
-      throw new Error(`Control Plane API Error (${response.status}): ${await response.text()}`);
+      throw new Error(
+        `Control Plane API Error (${response.status}): ${await response.text()}`
+      );
     }
     return response.json();
   }
@@ -19755,9 +19778,12 @@ var Environment = class extends Session {
   async disconnect() {
     let wsNotifiedRuntime = false;
     try {
-      const goodbye = await this.rpc("client.goodbye", {
-        timestamp: Date.now()
-      });
+      const goodbye = await this.rpc(
+        "client.goodbye",
+        {
+          timestamp: Date.now()
+        }
+      );
       wsNotifiedRuntime = Boolean(goodbye?.ok && goodbye?.via);
     } catch {
       wsNotifiedRuntime = false;
@@ -19771,8 +19797,8 @@ var Environment = class extends Session {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
-              "Authorization": `Bearer ${this._apiKey}`,
-              "Connection": "close"
+              Authorization: `Bearer ${this._apiKey}`,
+              Connection: "close"
             },
             body: JSON.stringify({
               reason: "sdk_disconnect_http_fallback",
@@ -19785,6 +19811,15 @@ var Environment = class extends Session {
     }
     this.client.disconnect();
   }
+  /**
+   * Close only the socket transport without sending `client.goodbye`.
+   *
+   * Use this when the caller intends to immediately reattach to the same
+   * session after an unexpected disconnect.
+   */
+  disconnectTransport() {
+    this.client.disconnect();
+  }
   // ==================== GRAPH CONTAINER READINESS ====================
   /** The last known graph container status, updated by checkReadiness() or on heartbeat */
   graphContainerStatus = null;
@@ -19850,14 +19885,14 @@ var Environment = class extends Session {
   }
   /**
    * Execute a GraphQL query against the environment's graph.
-   * 
+   *
    * The query uses the Granular graph query language (based on Cypher/GraphQL).
    * Authentication is handled automatically using the SDK's API key.
-   * 
+   *
    * @param query - The GraphQL query string
    * @param variables - Optional variables for the query
    * @returns The query result data
-   * 
+   *
    * @example
    * ```typescript
    * // Read the workspace
@@ -19865,7 +19900,7 @@ var Environment = class extends Session {
    *   `query { model(path: "workspace") { path label submodels { path label } } }`
    * );
    * console.log(result.data);
-   * 
+   *
    * // Create a model
    * const created = await env.graphql(
    *   `mutation { at(path: "workspace") { create_submodel(subpath: "my_node", label: "My Node", prototype: "Model") { model { path label } } } }`
@@ -19877,7 +19912,7 @@ var Environment = class extends Session {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "Authorization": `Bearer ${this._apiKey}`
+        Authorization: `Bearer ${this._apiKey}`
       },
       body: JSON.stringify({
         environmentId: this.environmentId,
@@ -19894,10 +19929,10 @@ var Environment = class extends Session {
   // ==================== RELATIONSHIP METHODS ====================
   /**
    * Define a relationship between two model types.
-   * 
+   *
    * Creates both submodels (if they don't exist) and links them with
    * a RelationshipDef node that encodes cardinality.
-   * 
+   *
    * @example
    * ```typescript
    * // Author has many Books, Book has one Author
@@ -19957,10 +19992,10 @@ var Environment = class extends Session {
   }
   /**
    * Get all relationships for a model type.
-   * 
+   *
    * @param modelPath - The model type path (e.g., "author")
    * @returns Array of relationships from this model's perspective
-   * 
+   *
    * @example
    * ```typescript
    * const rels = await env.getRelationships('author');
@@ -19993,18 +20028,18 @@ var Environment = class extends Session {
   }
   /**
    * Attach a target model to a relationship submodel.
-   * 
+   *
    * Handles cardinality automatically:
    * - "One" side: sets/replaces the reference
    * - "Many" side: adds the target to the collection
-   * 
+   *
    * If the target model doesn't exist, it's created as an instance of the foreign type.
    * Bidirectional sync is automatic.
-   * 
+   *
    * @param modelPath - The model instance path (e.g., "tolkien")
    * @param submodelPath - The relationship submodel (e.g., "books")
    * @param targetPath - The target model to attach (e.g., "lord_of_the_rings")
-   * 
+   *
    * @example
    * ```typescript
    * // Attach a book to an author (many side)
@@ -20031,18 +20066,18 @@ var Environment = class extends Session {
   }
   /**
    * Detach a target model from a relationship submodel.
-   * 
+   *
    * Handles bidirectional cleanup automatically.
-   * 
+   *
    * @param modelPath - The model instance path
    * @param submodelPath - The relationship submodel
    * @param targetPath - The target to detach (optional for "one" side; omit on "many" side to detach all)
-   * 
+   *
    * @example
    * ```typescript
    * // Detach a specific book
    * await env.detach('tolkien', 'books', 'lord_of_the_rings');
-   * 
+   *
    * // Detach all books
    * await env.detach('tolkien', 'books');
    * ```
@@ -20066,11 +20101,11 @@ var Environment = class extends Session {
   }
   /**
    * List all related models through a relationship submodel.
-   * 
+   *
    * @param modelPath - The model instance path
    * @param submodelPath - The relationship submodel
    * @returns Array of related model references
-   * 
+   *
    * @example
    * ```typescript
    * const books = await env.listRelated('tolkien', 'books');
@@ -20094,14 +20129,14 @@ var Environment = class extends Session {
   }
   /**
    * Apply a manifest to the current environment's graph.
-   * 
+   *
    * Translates each manifest operation into GraphQL mutations and executes them
    * in order. This is the core mechanism for creating classes, fields, and
    * relationships from a declarative manifest.
-   * 
+   *
    * @param manifest - The manifest content to apply
    * @returns Summary of applied operations
-   * 
+   *
    * @example
    * ```typescript
    * await environment.applyManifest({
@@ -20139,12 +20174,16 @@ var Environment = class extends Session {
                 applied++;
               } catch (err) {
                 if (!err.message?.includes("already exists")) {
-                  errors.push(`Import ${imp.name} operation failed: ${err.message}`);
+                  errors.push(
+                    `Import ${imp.name} operation failed: ${err.message}`
+                  );
                 }
               }
             }
           } else {
-            errors.push(`Unknown module: "${imp.name}" (only built-in modules are supported)`);
+            errors.push(
+              `Unknown module: "${imp.name}" (only built-in modules are supported)`
+            );
           }
         }
       }
@@ -20228,7 +20267,10 @@ var Environment = class extends Session {
     }
   }
   async _applyEffectMetamodels(toolPath, metamodels) {
-    for (const mutation of buildEffectMetamodelMutations(toolPath, metamodels)) {
+    for (const mutation of buildEffectMetamodelMutations(
+      toolPath,
+      metamodels
+    )) {
       await this._runGraphql(mutation.query, mutation.label);
     }
   }
@@ -20277,7 +20319,9 @@ var Environment = class extends Session {
       }
       if (eventType.payloadSchema?.properties) {
         const fieldSpecs = {};
-        for (const [propName, propSchema] of Object.entries(eventType.payloadSchema.properties)) {
+        for (const [propName, propSchema] of Object.entries(
+          eventType.payloadSchema.properties
+        )) {
           const schema = propSchema;
           fieldSpecs[propName] = {
             type: schema.type ?? "string",
@@ -20560,7 +20604,9 @@ var Environment = class extends Session {
       const wave = plans.slice(waveStart, waveStart + concurrency);
       await Promise.all(
         wave.map(async (plan) => {
-          const { items, durationMs } = await this.executeRecordObjectsChunk(plan.slice);
+          const { items, durationMs } = await this.executeRecordObjectsChunk(
+            plan.slice
+          );
           if (items.length !== plan.slice.length) {
             throw new Error(
               `recordObjects: chunk ${plan.chunkIndex + 1} returned ${items.length} results, expected ${plan.slice.length}`
@@ -20590,13 +20636,10 @@ var Environment = class extends Session {
     let lastError;
     for (let attempt = 1; attempt <= DEFAULT_DIRECT_RECORD_OBJECTS_RETRY_COUNT; attempt += 1) {
       try {
-        const response = await this.controlPlaneRequest(
-          `/control/environments/${this.environmentId}/records/batch`,
-          {
-            method: "POST",
-            body: JSON.stringify({ records: chunk })
-          }
-        );
+        const response = await this.controlPlaneRequest(`/control/environments/${this.environmentId}/records/batch`, {
+          method: "POST",
+          body: JSON.stringify({ records: chunk })
+        });
         const items = Array.isArray(response.items) ? response.items : [];
         return { items, durationMs: Date.now() - wallStart };
       } catch (error2) {
@@ -20659,7 +20702,9 @@ var Environment = class extends Session {
    * Fetch a single record import by id.
    */
   async getRecordImport(importId) {
-    return this.controlPlaneRequest(`/control/record-imports/${importId}`);
+    return this.controlPlaneRequest(
+      `/control/record-imports/${importId}`
+    );
   }
   /**
    * Cancel a queued/background record import.
@@ -20726,7 +20771,9 @@ var Granular = class _Granular {
   constructor(options) {
     const auth = options.token ?? options.apiKey;
     if (!auth) {
-      throw new Error("Granular client requires either apiKey or token. Set GRANULAR_API_KEY or GRANULAR_TOKEN, or pass one in options.");
+      throw new Error(
+        "Granular client requires either apiKey or token. Set GRANULAR_API_KEY or GRANULAR_TOKEN, or pass one in options."
+      );
     }
     this.apiUrl = resolveApiUrl(options.apiUrl, options.endpointMode);
     this.apiKey = resolveAuthTokenForApiUrl(auth, this.apiUrl);
@@ -20738,10 +20785,10 @@ var Granular = class _Granular {
   }
   /**
    * Records/upserts a user and prepares them for sandbox connections
-   * 
+   *
    * @param options - User options
    * @returns The recorded user with both `userId` and `granularId`
-   * 
+   *
    * @example
    * ```typescript
    * const user = await granular.recordUser({
@@ -20752,14 +20799,16 @@ var Granular = class _Granular {
    * ```
    */
   async recordUser(options) {
-    const subject = normalizeSubject(await this.request("/control/subjects", {
-      method: "POST",
-      body: JSON.stringify({
-        identityId: options.userId,
-        name: options.name,
-        email: options.email
+    const subject = normalizeSubject(
+      await this.request("/control/subjects", {
+        method: "POST",
+        body: JSON.stringify({
+          identityId: options.userId,
+          name: options.name,
+          email: options.email
+        })
       })
-    }));
+    );
     return normalizeUser({
       granularId: subject.granularId,
       userId: options.userId,
@@ -20806,18 +20855,20 @@ var Granular = class _Granular {
         permissions: options.permissions || []
       };
     }
-    throw new Error("connect() requires either userId, granularId, or a user object returned by recordUser().");
+    throw new Error(
+      "connect() requires either userId, granularId, or a user object returned by recordUser()."
+    );
   }
   /**
    * Connect to an ontology environment and establish a real-time session.
-   * 
+   *
    * Effects are registered at the sandbox level via `granular.registerEffect()`
    * or `granular.registerEffects()`. Sessions pick up live availability from
    * the sandbox registry automatically.
-   * 
+   *
    * @param options - Connection options
    * @returns An active environment session
-   * 
+   *
    * @example
    * ```typescript
    * const environment = await granular.connect({
@@ -20826,23 +20877,23 @@ var Granular = class _Granular {
    *   userId: 'user_123',
    *   permissions: ['agent'],
    * });
-   * 
+   *
    * await granular.registerEffect('my-sandbox', {
    *   name: 'greet',
    *   description: 'Say hello',
    *   inputSchema: { type: 'object', properties: {} },
    *   handler: async () => 'Hello!',
    * });
-   * 
+   *
    * // Submit job
    * const job = await environment.submitJob(`
    *   import { tools } from './sandbox-tools';
    *   return await tools.greet({});
    * `);
-   * 
+   *
    * console.log(await job.result); // 'Hello!'
    * ```
-  */
+   */
   async connect(options) {
     const clientId = options.clientId || `client_${Date.now()}`;
     const ontology = options.ontology;
@@ -20857,8 +20908,15 @@ var Granular = class _Granular {
     const user = await this.resolveConnectUser(options);
     const sandbox = await this.findOrCreateSandbox(ontology);
     for (const profileName of user.permissions) {
-      const profileId = await this.ensurePermissionProfile(sandbox.sandboxId, profileName);
-      await this.ensureAssignment(user.granularId, sandbox.sandboxId, profileId);
+      const profileId = await this.ensurePermissionProfile(
+        sandbox.sandboxId,
+        profileName
+      );
+      await this.ensureAssignment(
+        user.granularId,
+        sandbox.sandboxId,
+        profileId
+      );
     }
     const envData = await this.environments.create(sandbox.sandboxId, {
       subjectId: user.granularId,
@@ -20910,7 +20968,9 @@ var Granular = class _Granular {
       createdAt: _Granular.coerceIsoDate(row.createdAt ?? row.created_at),
       lastSeenAt: _Granular.coerceIsoDate(row.lastSeenAt ?? row.last_seen_at),
       summary: row.summary != null ? String(row.summary) : null,
-      summaryUpdatedAt: row.summaryUpdatedAt != null || row.summary_updated_at != null ? _Granular.coerceIsoDate(row.summaryUpdatedAt ?? row.summary_updated_at) : null,
+      summaryUpdatedAt: row.summaryUpdatedAt != null || row.summary_updated_at != null ? _Granular.coerceIsoDate(
+        row.summaryUpdatedAt ?? row.summary_updated_at
+      ) : null,
       subjectId: row.subjectId != null ? String(row.subjectId) : null,
       jobCount: typeof row.jobCount === "number" ? row.jobCount : void 0,
       toolCallCount: typeof row.toolCallCount === "number" ? row.toolCallCount : void 0
@@ -21000,7 +21060,13 @@ var Granular = class _Granular {
     });
     await client.connect();
     const graphqlEndpoint = `${this.httpUrl}/orchestrator/graphql`;
-    const environment = new Environment(client, envData, clientId, this.apiKey, graphqlEndpoint);
+    const environment = new Environment(
+      client,
+      envData,
+      clientId,
+      this.apiKey,
+      graphqlEndpoint
+    );
     await environment.hello();
     return environment;
   }
@@ -21034,14 +21100,18 @@ var Granular = class _Granular {
     };
   }
   async publishSandboxEffectCatalog(host) {
-    const effects2 = Array.from(this.getSandboxEffectMap(host.sandboxId).values()).map(
-      (effect) => this.serializeEffect(effect)
-    );
-    const result = await host.wsClient.call("effects.publishCatalog", { effects: effects2 });
+    const effects2 = Array.from(
+      this.getSandboxEffectMap(host.sandboxId).values()
+    ).map((effect) => this.serializeEffect(effect));
+    const result = await host.wsClient.call("effects.publishCatalog", {
+      effects: effects2
+    });
     const acceptedCount = typeof result?.acceptedCount === "number" ? result.acceptedCount : 0;
     const rejected = Array.isArray(result?.rejected) ? result.rejected : [];
     if (acceptedCount === 0 && rejected.length > 0) {
-      const detail = rejected.map((entry) => `${entry.name || "unknown"}: ${entry.reason || "rejected"}`).join("; ");
+      const detail = rejected.map(
+        (entry) => `${entry.name || "unknown"}: ${entry.reason || "rejected"}`
+      ).join("; ");
       throw new Error(
         `Failed to publish live effects for sandbox ${host.sandboxId}: ${detail}`
       );
@@ -21075,13 +21145,15 @@ var Granular = class _Granular {
         disconnectError
       );
     }
-    void this.ensureSandboxEffectHost(host.sandboxId).catch((reconnectError) => {
-      console.error(
-        `[Granular] Failed to recover effect host for sandbox ${host.sandboxId} after heartbeat failure:`,
-        reconnectError
-      );
-      console.error("[Granular] Original heartbeat failure:", error2);
-    });
+    void this.ensureSandboxEffectHost(host.sandboxId).catch(
+      (reconnectError) => {
+        console.error(
+          `[Granular] Failed to recover effect host for sandbox ${host.sandboxId} after heartbeat failure:`,
+          reconnectError
+        );
+        console.error("[Granular] Original heartbeat failure:", error2);
+      }
+    );
   }
   startEffectHostHeartbeat(host) {
     if (host.heartbeatTimer) {
@@ -21102,9 +21174,15 @@ var Granular = class _Granular {
         host.heartbeatInFlight = false;
       });
     };
-    sendHeartbeat("[Granular] Initial effect host heartbeat failed for sandbox", false);
+    sendHeartbeat(
+      "[Granular] Initial effect host heartbeat failed for sandbox",
+      false
+    );
     host.heartbeatTimer = setInterval(() => {
-      sendHeartbeat("[Granular] Effect host heartbeat failed for sandbox", true);
+      sendHeartbeat(
+        "[Granular] Effect host heartbeat failed for sandbox",
+        true
+      );
     }, 1e4);
   }
   stopEffectHostHeartbeat(host) {
@@ -21136,7 +21214,12 @@ var Granular = class _Granular {
       const effectClientId = crypto.randomUUID();
       const clientId = `effect-host:${sandboxId}:${effectClientId}`;
       const wsClient = new WSClient({
-        url: buildEffectHostUrl(this.apiUrl, sandboxId, effectClientId, clientId),
+        url: buildEffectHostUrl(
+          this.apiUrl,
+          sandboxId,
+          effectClientId,
+          clientId
+        ),
         sessionId: `effect-host:${effectClientId}`,
         token: this.apiKey,
         tokenProvider: this.tokenProvider,
@@ -21155,7 +21238,10 @@ var Granular = class _Granular {
       };
       wsClient.registerRpcHandler("effect.invoke", async (params) => {
         const request = params;
-        return invokeRegisteredEffect(this.getSandboxEffectMap(sandboxId), request);
+        return invokeRegisteredEffect(
+          this.getSandboxEffectMap(sandboxId),
+          request
+        );
       });
       wsClient.on("open", () => {
         void this.synchronizeEffectHost(host).catch((error2) => {
@@ -21203,7 +21289,7 @@ var Granular = class _Granular {
   }
   /**
    * Register multiple effects (tools) for a specific sandbox.
-   * 
+   *
    * batch version of `registerEffect`.
    */
   async registerEffects(sandboxNameOrId, effects2) {
@@ -21217,7 +21303,7 @@ var Granular = class _Granular {
   }
   /**
    * Unregister an effect from a sandbox.
-   * 
+   *
    * Removes it from the local sandbox registry and updates the
    * sandbox-scoped live catalog.
    */
@@ -21316,27 +21402,31 @@ var Granular = class _Granular {
       const assignments = await this.request(
         `/control/subjects/${subjectId}/assignments`
       );
-      const existing = assignments.items.find(
-        (a) => a.sandboxId === sandboxId
-      );
+      const existing = assignments.items.find((a) => a.sandboxId === sandboxId);
       if (existing) {
         if (existing.permissionProfileId === permissionProfileId) {
           return;
         }
-        await this.request(`/control/assignments/${existing.assignmentId}`, {
-          method: "DELETE"
-        });
+        await this.request(
+          `/control/assignments/${existing.assignmentId}`,
+          {
+            method: "DELETE"
+          }
+        );
       }
     } catch {
     }
-    await this.request(`/control/subjects/${subjectId}/assignments`, {
-      method: "POST",
-      body: JSON.stringify({
-        sandboxId,
-        subjectId,
-        permissionProfileId
-      })
-    });
+    await this.request(
+      `/control/subjects/${subjectId}/assignments`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          sandboxId,
+          subjectId,
+          permissionProfileId
+        })
+      }
+    );
   }
   /**
    * Sandbox management API
@@ -21416,23 +21506,33 @@ var Granular = class _Granular {
       },
       get: async (environmentId) => {
         return normalizeEnvironmentData(
-          await this.request(`/control/environments/${environmentId}`)
+          await this.request(
+            `/control/environments/${environmentId}`
+          )
         );
       },
       create: async (sandboxId, data) => {
         const environmentName = data.environment || data.envName;
-        return normalizeEnvironmentData(await this.request(`/control/sandboxes/${sandboxId}/environments`, {
-          method: "POST",
-          body: JSON.stringify({
-            ...data,
-            envName: environmentName
-          })
-        }));
+        return normalizeEnvironmentData(
+          await this.request(
+            `/control/sandboxes/${sandboxId}/environments`,
+            {
+              method: "POST",
+              body: JSON.stringify({
+                ...data,
+                envName: environmentName
+              })
+            }
+          )
+        );
       },
       delete: async (environmentId) => {
-        return this.request(`/control/environments/${environmentId}`, {
-          method: "DELETE"
-        });
+        return this.request(
+          `/control/environments/${environmentId}`,
+          {
+            method: "DELETE"
+          }
+        );
       }
     };
   }
@@ -21452,10 +21552,13 @@ var Granular = class _Granular {
         }
         if (params.since) query.set("since", params.since.toISOString());
         if (params.until) query.set("until", params.until.toISOString());
-        if (params.isAcked !== void 0) query.set("isAcked", params.isAcked ? "1" : "0");
+        if (params.isAcked !== void 0)
+          query.set("isAcked", params.isAcked ? "1" : "0");
         if (params.limit) query.set("limit", String(params.limit));
         if (params.offset) query.set("offset", String(params.offset));
-        const result = await this.request(`/control/stream-events?${query.toString()}`);
+        const result = await this.request(
+          `/control/stream-events?${query.toString()}`
+        );
         return (result.items || []).map((row) => ({
           eventId: row.event_id,
           streamName: row.stream_name,
@@ -21486,7 +21589,9 @@ var Granular = class _Granular {
                 since: cursor,
                 limit: 100
               });
-              const orderedEvents = [...events].sort((a, b) => a.createdAt - b.createdAt);
+              const orderedEvents = [...events].sort(
+                (a, b) => a.createdAt - b.createdAt
+              );
               for (const event of orderedEvents) {
                 if (seenEventIds.has(event.eventId)) {
                   continue;
@@ -21499,15 +21604,19 @@ var Granular = class _Granular {
                 params.onEvent(event);
               }
             } catch (err) {
-              params.onError?.(err instanceof Error ? err : new Error(String(err)));
+              params.onError?.(
+                err instanceof Error ? err : new Error(String(err))
+              );
             }
             await new Promise((resolve2) => setTimeout(resolve2, interval));
           }
         };
         poll();
-        return { unsubscribe: () => {
-          running = false;
-        } };
+        return {
+          unsubscribe: () => {
+            running = false;
+          }
+        };
       },
       ack: async (eventId) => {
         await this.request("/control/stream-events/ack", {
@@ -21525,7 +21634,9 @@ var Granular = class _Granular {
         const sandbox = await this._resolveSandboxId(params.ontology);
         const query = new URLSearchParams({ sandboxId: sandbox });
         if (params.environment) query.set("environmentId", params.environment);
-        const result = await this.request(`/control/stream-events/stats?${query.toString()}`);
+        const result = await this.request(
+          `/control/stream-events/stats?${query.toString()}`
+        );
         return (result.items || []).map((row) => ({
           streamName: row.stream_name,
           eventType: row.event_type,
@@ -21543,10 +21654,14 @@ var Granular = class _Granular {
   get subjects() {
     return {
       get: async (subjectId) => {
-        return normalizeSubject(await this.request(`/control/subjects/${subjectId}`));
+        return normalizeSubject(
+          await this.request(`/control/subjects/${subjectId}`)
+        );
       },
       listAssignments: async (subjectId) => {
-        return this.request(`/control/subjects/${subjectId}/assignments`);
+        return this.request(
+          `/control/subjects/${subjectId}/assignments`
+        );
       }
     };
   }
@@ -21556,24 +21671,31 @@ var Granular = class _Granular {
   get users() {
     return {
       create: async (data) => {
-        return normalizeSubject(await this.request("/control/subjects", {
-          method: "POST",
-          body: JSON.stringify({
-            identityId: data.id,
-            name: data.name,
-            email: data.email
+        return normalizeSubject(
+          await this.request("/control/subjects", {
+            method: "POST",
+            body: JSON.stringify({
+              identityId: data.id,
+              name: data.name,
+              email: data.email
+            })
           })
-        }));
+        );
       },
       get: async (id) => {
-        return normalizeSubject(await this.request(`/control/subjects/${id}`));
+        return normalizeSubject(
+          await this.request(`/control/subjects/${id}`)
+        );
       }
     };
   }
   async _resolveSandboxId(ontologyNameOrId) {
     if (ontologyNameOrId.startsWith("sbx_")) return ontologyNameOrId;
-    const result = await this.request(`/control/sandboxes?name=${encodeURIComponent(ontologyNameOrId)}`);
-    if (result.items.length === 0) throw new Error(`Ontology not found: ${ontologyNameOrId}`);
+    const result = await this.request(
+      `/control/sandboxes?name=${encodeURIComponent(ontologyNameOrId)}`
+    );
+    if (result.items.length === 0)
+      throw new Error(`Ontology not found: ${ontologyNameOrId}`);
     return result.items[0].sandboxId;
   }
   /**
@@ -21588,9 +21710,9 @@ var Granular = class _Granular {
       const response = await fetch(url, {
         ...options,
         headers: {
-          "Authorization": `Bearer ${this.apiKey}`,
+          Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "Connection": "close",
+          Connection: "close",
           ...options.headers
         }
       });
@@ -21601,7 +21723,11 @@ var Granular = class _Granular {
         return response.json();
       }
       const errorText = await response.text();
-      const retryable = isRetryableLocalWorkerRestart(response.status, errorText, url);
+      const retryable = isRetryableLocalWorkerRestart(
+        response.status,
+        errorText,
+        url
+      );
       if (retryable && attempt < LOCAL_CONTROL_REQUEST_RETRY_COUNT) {
         if (this.debugHttp) {
           console.warn(