@granular-software/sdk 0.4.62 → 0.4.64

package/dist/index.js

@@ -12219,8 +12219,12 @@ external_exports.union([
   external_exports.array(external_exports.string()),
   external_exports.object({
     values: external_exports.array(external_exports.string()),
+    labels: external_exports.array(external_exports.string().min(1)).optional(),
     message: external_exports.string().optional()
-  }).strict()
+  }).strict().refine(
+    (rule) => !rule.labels || rule.labels.length === rule.values.length,
+    { message: "Enum labels must match enum values one-for-one" }
+  )
 ]);
 external_exports.union([
   external_exports.boolean(),
@@ -12248,7 +12252,7 @@ var StateMachineStateSchema = external_exports.union([
   external_exports.string(),
   external_exports.object({
     name: external_exports.string().min(1),
-    label: external_exports.string().optional(),
+    label: external_exports.string().min(1).optional(),
     description: external_exports.string().optional(),
     isFinal: external_exports.boolean().optional()
   }).strict()
@@ -13142,7 +13146,7 @@ function resolveHandlerForMode(effectMap, effect, request) {
   if (mode === "artifactOptions") {
     if (!effect.artifactOptionsHandler) {
       throw new Error(
-        `Artifact relationship options are not supported for ${request.effectKey}`
+        `Artifact field options are not supported for ${request.effectKey}`
       );
     }
     return {
@@ -13644,18 +13648,24 @@ function normalizeEnumInput(enumSpec) {
     (value) => typeof value === "string" && value.length > 0
   );
   if (values.length === 0) return null;
-  return config.message ? { values, message: config.message } : { values };
+  const labels = Array.isArray(config.labels) && config.labels.length === values.length ? config.labels : values;
+  return {
+    values,
+    labels,
+    ...config.message ? { message: config.message } : {}
+  };
 }
 function buildEnumFieldMutations(fieldPath, enumSpec) {
   const normalized = normalizeEnumInput(enumSpec);
   if (!normalized) return [];
   const messageArg = normalized.message ? `, message: ${JSON.stringify(normalized.message)}` : "";
+  const labelsArg = normalized.labels ? `, labels: ${JSON.stringify(normalized.labels)}` : "";
   return [
     {
       label: `set enum on ${fieldPath}`,
       query: `mutation { at(path: ${JSON.stringify(fieldPath)}) { set_enum(values: ${JSON.stringify(
         normalized.values
-      )}${messageArg}) { values } } }`
+      )}${labelsArg}${messageArg}) { values labels } } }`
     }
   ];
 }
@@ -13665,7 +13675,7 @@ var enumMetamodelPackage = defineMetamodelPackage({
     fieldRows: [
       {
         key: "enum",
-        description: 'Allowed values. Accepts `["a", "b"]` or `{ "values": [...], "message": "..." }`.'
+        description: 'Allowed values. Use `{ "values": [...], "labels": [...] }` for authored display labels; otherwise each unchanged value is its display fallback.'
       }
     ]
   },
@@ -13675,6 +13685,7 @@ var enumMetamodelPackage = defineMetamodelPackage({
       type EnumMetamodel {
         model: Model!
         values: [String!]!
+        labels: [String!]!
         message: String
       }
 
@@ -13683,7 +13694,7 @@ var enumMetamodelPackage = defineMetamodelPackage({
       }
 
       extend type ModelMutation {
-        set_enum(values: [String!]!, message: String): EnumMetamodel
+        set_enum(values: [String!]!, labels: [String!], message: String): EnumMetamodel
       }
       `
     ],
@@ -13692,15 +13703,19 @@ var enumMetamodelPackage = defineMetamodelPackage({
         EnumMetamodel: {
           model: (value) => value.model,
           values: (value) => value.values,
+          labels: (value) => value.labels || [],
           message: (value) => value.message || null
         },
         Model: {
           enum_rule: async (ant) => await run(ant.enum_rule())
         },
         ModelMutation: {
-          set_enum: async (ant, { values, message }) => {
-            const model = await run(ant.set_enum(values, message));
-            return { model, values, message };
+          set_enum: async (ant, { values, labels, message }) => {
+            const resolvedLabels = Array.isArray(labels) && labels.length === values.length ? labels : values;
+            const model = await run(
+              ant.set_enum(values, resolvedLabels, message)
+            );
+            return { model, values, labels: resolvedLabels, message };
           }
         }
       };
@@ -13713,7 +13728,7 @@ var enumMetamodelPackage = defineMetamodelPackage({
   },
   summary: {
     selections: {
-      propertyFields: [`enum_rule { values message }`]
+      propertyFields: [`enum_rule { values labels message }`]
     },
     readPropertySummary(rawProperty) {
       const values = Array.isArray(rawProperty.enum_rule?.values) ? rawProperty.enum_rule.values.filter(
@@ -13721,8 +13736,15 @@ var enumMetamodelPackage = defineMetamodelPackage({
       ) : [];
       if (values.length === 0) return { enumRule: null };
       const message = typeof rawProperty.enum_rule?.message === "string" ? rawProperty.enum_rule.message : null;
+      const labels = Array.isArray(rawProperty.enum_rule?.labels) ? rawProperty.enum_rule.labels.filter(
+        (label) => typeof label === "string" && label.length > 0
+      ) : [];
       return {
-        enumRule: message ? { values, message } : { values }
+        enumRule: {
+          values,
+          ...labels.length === values.length ? { labels } : {},
+          ...message ? { message } : {}
+        }
       };
     }
   },
@@ -15353,7 +15375,6 @@ function buildEffectMetamodelMutations(toolPath, spec) {
 // src/client.ts
 var DEFAULT_CONVERSATION_SESSION_LIST_LIMIT = 100;
 var MAX_CONVERSATION_SESSION_LIST_LIMIT = 500;
-var MAX_CONVERSATION_SESSION_LIST_OFFSET = 1e5;
 function requireUserEnvironmentSequence(value, field) {
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
     throw new Error(
@@ -15733,6 +15754,10 @@ var Environment = class _Environment {
   get sessions() {
     return {
       list: async (options = {}) => this.listSessions(options),
+      page: async (options = {}) => this.granular.listSessionsPage({
+        ...options,
+        environmentId: this.environmentId
+      }),
       create: async (options) => this.createSession(options),
       connect: async (sessionId, options) => this.connectSession(sessionId, options),
       reopen: async (sessionId, options) => this.reopenSession(sessionId, options),
@@ -15988,7 +16013,6 @@ var Environment = class _Environment {
       headers: {
         Authorization: `Bearer ${this._apiKey}`,
         "Content-Type": "application/json",
-        Connection: "close",
         ...options.headers
       }
     });
@@ -17512,8 +17536,7 @@ var EnvironmentSession = class extends Session {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
-              Authorization: `Bearer ${this.environment.authToken}`,
-              Connection: "close"
+              Authorization: `Bearer ${this.environment.authToken}`
             },
             body: JSON.stringify({
               reason: "sdk_disconnect_http_fallback",
@@ -18215,6 +18238,21 @@ var Granular = class _Granular {
    * List indexed sessions using ownership filters and bounded pagination.
    */
   async listSessions(options) {
+    const items = [];
+    let cursor = options.cursor?.trim() || void 0;
+    let pageCount = 0;
+    do {
+      const page = await this.listSessionsPage({ ...options, cursor });
+      items.push(...page.items);
+      cursor = page.nextCursor || void 0;
+      pageCount += 1;
+      if (pageCount > 1e4) {
+        throw new Error("Session pagination exceeded the safe page limit");
+      }
+    } while (cursor);
+    return items;
+  }
+  async listSessionsPage(options) {
     const environmentId = options.environmentId?.trim();
     const sandboxId = options.sandboxId?.trim();
     const subjectId = options.subjectId?.trim();
@@ -18242,17 +18280,14 @@ var Granular = class _Granular {
       1,
       MAX_CONVERSATION_SESSION_LIST_LIMIT
     );
-    const offset = boundedSessionListInteger(
-      options.offset,
-      "offset",
-      0,
-      0,
-      MAX_CONVERSATION_SESSION_LIST_OFFSET
-    );
+    const cursor = options.cursor?.trim();
+    if (options.cursor !== void 0 && !cursor) {
+      throw new Error("Session list cursor must be a non-empty string.");
+    }
     const query = new URLSearchParams({
-      limit: String(limit),
-      offset: String(offset)
+      limit: String(limit)
     });
+    if (cursor) query.set("cursor", cursor);
     if (environmentId) query.set("environmentId", environmentId);
     if (sandboxId) query.set("sandboxId", sandboxId);
     if (subjectId) query.set("userId", subjectId);
@@ -18260,11 +18295,13 @@ var Granular = class _Granular {
       query.set("sessionScope", options.sessionScope.trim());
     }
     if (status !== "all") query.set("status", status);
-    const res = await this.request(
-      `/control/sessions?${query.toString()}`
-    );
-    const items = Array.isArray(res.items) ? res.items : [];
-    return items.map((row) => this.normalizeConversationSession(row));
+    const res = await this.request(`/control/sessions?${query.toString()}`);
+    const items = Array.isArray(res.items) ? res.items.map((row) => this.normalizeConversationSession(row)) : [];
+    const nextCursor = res.nextCursor ?? null;
+    if (nextCursor === cursor) {
+      throw new Error("Session pagination cursor did not advance");
+    }
+    return { items, nextCursor };
   }
   /**
    * List active (open) sessions for an environment.
@@ -18291,9 +18328,6 @@ var Granular = class _Granular {
     if (typeof options.limit === "number") {
       query.set("limit", String(options.limit));
     }
-    if (typeof options.offset === "number") {
-      query.set("offset", String(options.offset));
-    }
     const state = await this.request(
       `/sdk/user-environment-state?${query.toString()}`
     );
@@ -19227,10 +19261,20 @@ var Granular = class _Granular {
   get environments() {
     return {
       list: async (sandboxId) => {
-        const result = await this.request(
-          `/control/sandboxes/${sandboxId}/environments`
-        );
-        return result.items.map(normalizeEnvironmentData);
+        const environments = [];
+        let cursor = null;
+        do {
+          const query = cursor ? `?limit=100&cursor=${encodeURIComponent(cursor)}` : "";
+          const result = await this.request(
+            `/control/sandboxes/${sandboxId}/environments${query}`
+          );
+          environments.push(...result.items.map(normalizeEnvironmentData));
+          if (result.nextCursor && result.nextCursor === cursor) {
+            throw new Error("Environment pagination cursor did not advance");
+          }
+          cursor = result.nextCursor;
+        } while (cursor);
+        return environments;
       },
       get: async (environmentId) => {
         return normalizeEnvironmentData(
@@ -19440,7 +19484,6 @@ var Granular = class _Granular {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          Connection: "close",
           ...options.headers
         }
       });