@gravity-rail/sdk 0.8.0 → 0.11.0

package/dist/index.js

@@ -6,16 +6,15 @@ import {
   AccessGrantStatus,
   AccessGrantTrigger,
   AccessLevel,
-  ApiError,
   AppsApi,
   BUILTIN_ASSISTANT_CHAT_TYPES,
-  BaseApiClient,
   BuildersApi,
   BulkMemberResultStatus,
   BusinessIndustry,
   BusinessType,
   CELApi,
   CHAT_TYPES,
+  CapabilityClass,
   ConsentMethod,
   CriterionType,
   DEFAULT_CHAT_MODEL,
@@ -38,6 +37,9 @@ import {
   MASKED_SECRET_SENTINEL,
   McpServerState,
   MemberFeature,
+  MemberImportMatchInfoMatchType,
+  MemberImportPreviewRowAction,
+  MemberImportValidationError,
   MemberType,
   MenuItemResponseItemType,
   ModelProvider,
@@ -57,7 +59,12 @@ import {
   PERMISSION_NONE,
   PERMISSION_USE,
   PERMISSION_VERIFY,
+  PIDS_DISPOSITIONS,
+  PIDS_SOURCES,
+  POSITIVE_RATING_THRESHOLD,
   ProductType,
+  QUERY_VALUELESS_OPS,
+  QueriesApi,
   REALTIME_MODEL_CUSTOM,
   REALTIME_MODEL_GEMINI,
   REALTIME_MODEL_GEMINI_VERTEX,
@@ -85,10 +92,10 @@ import {
   TTS_MODEL_ELEVENLABS_FLASH,
   TTS_MODEL_ELEVENLABS_MULTILINGUAL,
   TTS_MODEL_ELEVENLABS_TURBO,
-  TTS_MODEL_POCKET,
   TTS_PREVIEW_PROVIDERS,
   TemplatesApi,
   ToolkitState,
+  WIDGET_SLUGS,
   WorkflowAccessWarningResourceType,
   WorkspaceFeature,
   WorkspaceProvisionStatus,
@@ -105,24 +112,25 @@ import {
   getApplicableResourceSlugs,
   getApplicableResources,
   getAvailableFeaturesForUpgrade,
-  getCookieValue,
   getFeature,
   getFeaturesByCategory,
   getFeaturesByVisibility,
   getMissingDependencies,
   getResourceMetadata,
+  getRevisionState,
   getScopeFromProductType,
   getTTSProvider,
   getVoiceModelId,
   initializeFeatures,
   isChatType,
   isFeatureAvailable,
+  isPositiveRating,
   isRegistryInitialized,
   isSMSDeliveryFailureStatus,
   requiresAssistantParticipant,
   usesBuiltinAssistant,
   validateFeatureDependencies
-} from "./chunk-ML55PVP7.js";
+} from "./chunk-YESHLUL7.js";
 import {
   AttendeeResponseStatus,
   AttendeeStatus,
@@ -133,10 +141,16 @@ import {
   CalendarSource,
   DataCategory,
   DataFieldType,
+  DataRecordRetirementResponseReason,
   DataSensitivity,
   DataTypeRecordScope,
   IndexStatus
-} from "./chunk-QS6ZRQUZ.js";
+} from "./chunk-V7ZKEH4V.js";
+import {
+  ApiError,
+  BaseApiClient,
+  getCookieValue
+} from "./chunk-FSSXKQR5.js";
 
 // src/workspace-builder/resource.ts
 function isRecord(value) {
@@ -155,6 +169,24 @@ var WorkspaceBuilderResource = class {
   _uuid;
   _created = false;
   _existed = false;
+  /** Server-assigned numeric id — available after apply() or adopt(). */
+  get id() {
+    if (this._id === void 0) {
+      throw new Error(
+        `${this.constructor.name} has no id yet \u2014 ids are assigned during apply(). Pass the builder object itself where a reference is needed; refs resolve at apply time.`
+      );
+    }
+    return this._id;
+  }
+  /** Server-assigned uuid — available after apply() or adopt(). */
+  get uuid() {
+    if (this._uuid === void 0) {
+      throw new Error(
+        `${this.constructor.name} has no uuid yet \u2014 uuids are assigned during apply(). Pass the builder object itself where a reference is needed; refs resolve at apply time.`
+      );
+    }
+    return this._uuid;
+  }
   matchKey() {
     return void 0;
   }
@@ -184,26 +216,25 @@ var MemberFilterBuilder = class extends WorkspaceBuilderResource {
     super();
     this.name = name;
     this.description = options.description ?? "";
+    this.query = options.query ?? null;
   }
+  name;
   description;
-  rules = [];
-  addRule(objectType, filterType, options = {}) {
-    this.rules.push({
-      objectType,
-      filterType,
-      ...options.objectIds ? { objectIds: options.objectIds } : {},
-      ...options.query ? { query: options.query } : {}
-    });
+  /** Query-engine predicate (JSON IR) authored on MemberFilter.query. */
+  query = null;
+  /** Set the filter's query-engine predicate (JSON IR). */
+  setQuery(query) {
+    this.query = query;
     return this;
   }
   planLine() {
-    return `MemberFilter: ${this.name}${this.rules.length ? ` (${this.rules.length} rules)` : ""}`;
+    return `MemberFilter: ${this.name}${this.query ? " (query)" : ""}`;
   }
   async apply(client) {
     const payload = {
       name: this.name,
       description: this.description,
-      rules: this.rules
+      query: this.query
     };
     const result = await client.createMemberFilter(payload);
     this._id = result.id;
@@ -219,6 +250,8 @@ var RoutineBuilder = class extends WorkspaceBuilderResource {
     this.active = options.active ?? false;
     this.description = options.description ?? "";
   }
+  name;
+  cronSchedule;
   active;
   description;
   rules = [];
@@ -280,6 +313,7 @@ var NotificationRuleBuilder = class extends WorkspaceBuilderResource {
     this.notifyEmail = Boolean(options.notifyEmail ?? options.notify_email);
     this.notifyVoice = Boolean(options.notifyVoice ?? options.notify_voice);
   }
+  name;
   noticeType;
   memberId;
   workflow;
@@ -504,6 +538,11 @@ var JourneyStepBuilder = class extends WorkspaceBuilderResource {
     this.workflow = workflow;
     this.description = description;
   }
+  name;
+  journey;
+  order;
+  workflow;
+  description;
   connections = [];
   connectsTo(child, condition, required = false, timeoutSeconds) {
     this.connections.push({ parent: this, child, condition, required, timeoutSeconds });
@@ -532,6 +571,7 @@ var JourneyBuilder = class extends WorkspaceBuilderResource {
     this.name = name;
     this.description = options.description ?? "";
   }
+  name;
   description;
   steps = [];
   goals = [];
@@ -602,6 +642,9 @@ var RoleUpdate = class extends WorkspaceBuilderResource {
     this.workflowIds = workflowIds;
     this.dataTypeIds = dataTypeIds;
   }
+  roleId;
+  workflowIds;
+  dataTypeIds;
   planLine() {
     const parts = [];
     if (this.workflowIds) parts.push(`workflows=${JSON.stringify(this.workflowIds)}`);
@@ -643,6 +686,7 @@ var AbilityDef = class {
       if (inputKey in options) this.perms[outputKey] = options[inputKey];
     }
   }
+  abilityType;
   uuid = crypto.randomUUID();
   config;
   enabled;
@@ -673,13 +717,25 @@ var TaskBuilder = class extends WorkspaceBuilderResource {
     this.start = start;
     this.description = description;
   }
+  name;
+  workflow;
+  prompt;
+  start;
+  description;
   transitions = [];
   eventRules = [];
-  transitionsTo(child, when, autoNext = false, required = false) {
+  transitionsTo(child, when, autoNext = false, required = false, celCondition) {
     if (child === this) {
       throw new Error(`Task '${this.name}' cannot transition to itself`);
     }
-    this.transitions.push({ parent: this, child, when, autoNext, required });
+    this.transitions.push({
+      parent: this,
+      child,
+      when,
+      autoNext,
+      required,
+      celCondition
+    });
     return this;
   }
   onEnter(action, params = {}, name) {
@@ -702,8 +758,13 @@ var TaskBuilder = class extends WorkspaceBuilderResource {
   }
   async apply(client) {
     if (this._existed || this.workflow._id === void 0) return;
+    if (this.workflow._draftRevisionId === void 0) {
+      throw new Error(
+        `Workflow '${this.workflow.name}' has no draft revision id; cannot create tasks. Tasks attach to a WorkflowRevision, not the stable workflow root.`
+      );
+    }
     const result = await client.createTask({
-      workflowId: this.workflow._id,
+      workflowRevisionId: this.workflow._draftRevisionId,
       name: this.name,
       prompt: this.prompt,
       description: this.description
@@ -719,13 +780,18 @@ var WorkflowBuilder = class extends WorkspaceBuilderResource {
     this.name = name;
     this.description = options.description ?? "";
     this.prompt = options.prompt;
-    this.agentId = options.agentId ?? options.agent_id;
+    this.copyFromAgentId = options.copyFromAgentId;
   }
+  name;
   description;
   prompt;
-  agentId;
+  copyFromAgentId;
   tasks = [];
   abilities = [];
+  /** The DRAFT revision's id — where tasks and graph edits attach.
+   * `_id` is the STABLE workflow root id; the two are different entities
+   * and (after any publish) different numbers. */
+  _draftRevisionId;
   task(name, options = {}) {
     const task = new TaskBuilder(
       name,
@@ -748,10 +814,14 @@ var WorkflowBuilder = class extends WorkspaceBuilderResource {
     return this.name;
   }
   adopt(existing) {
-    super.adopt(existing);
+    const root = existing.workflow ?? existing;
+    super.adopt(root);
+    const draft = existing.draftRevision;
+    this._draftRevisionId = draft?.id ?? root.draftRevisionId;
     const start = this.startTask;
-    if (start && existing.startTaskId) {
-      start._id = existing.startTaskId;
+    const startTaskId = draft?.startTaskId;
+    if (start && startTaskId) {
+      start._id = startTaskId;
       start._existed = true;
     }
   }
@@ -761,12 +831,6 @@ var WorkflowBuilder = class extends WorkspaceBuilderResource {
     if (this.abilities.length) details.push(`${this.abilities.length} abilities`);
     return `Workflow: ${this.name}${details.length ? ` (${details.join(", ")})` : ""}`;
   }
-  needsDefaultAgent() {
-    return !this._existed && this.agentId === void 0;
-  }
-  setAgentId(agentId) {
-    this.agentId = agentId;
-  }
   async apply(client) {
     if (this._existed) return;
     const payload = {
@@ -774,63 +838,16 @@ var WorkflowBuilder = class extends WorkspaceBuilderResource {
       description: this.description,
       createMode: "taskless",
       ...this.prompt ? { prompt: this.prompt } : {},
-      ...this.agentId ? { agentId: this.agentId } : {},
+      ...this.copyFromAgentId ? { copyFromAgentId: this.copyFromAgentId } : {},
       ...this.abilities.length ? { abilities: this.abilities.map((ability) => ability.toAbility()) } : {}
     };
     const result = await client.createWorkflow(payload);
-    this._id = result.id;
-    this._uuid = result.uuid;
+    this._id = result.workflow.id;
+    this._uuid = result.workflow.uuid;
+    this._draftRevisionId = result.draftRevision.id;
     this._created = true;
   }
 };
-var WORKSPACE_BUILDER_DEFAULT_AGENT_NAME = "Workspace Setup Agent";
-var WORKSPACE_BUILDER_DEFAULT_AGENT_PROMPT = "You help workspace members complete the workflow you are assigned to. Follow the task prompts, collect requested information accurately, and escalate when the workflow asks you to.";
-async function getOrCreateDefaultWorkflowAgent(client) {
-  const existingAgents = recordsFromResponse(
-    await client.getAgents({ pageSize: 100, includeArchived: false })
-  );
-  const existing = existingAgents.find((agent) => !agent.isArchived) ?? existingAgents[0];
-  if (existing) {
-    return {
-      id: numberField(existing, "id"),
-      name: stringField(existing, "name"),
-      created: false
-    };
-  }
-  const roles = recordsFromResponse(await client.getMemberRoles());
-  const role = roles.find((candidate) => stringField(candidate, "name").toLowerCase() === "agent") ?? roles[0];
-  if (!role) {
-    throw new Error("Cannot create default workflow agent: workspace has no member roles");
-  }
-  const payload = {
-    name: WORKSPACE_BUILDER_DEFAULT_AGENT_NAME,
-    memberRoleId: numberField(role, "id"),
-    chatModelId: DEFAULT_CHAT_MODEL,
-    systemPrompt: WORKSPACE_BUILDER_DEFAULT_AGENT_PROMPT
-  };
-  const created = await client.createAgent(payload);
-  return {
-    id: created.id,
-    name: created.name ?? WORKSPACE_BUILDER_DEFAULT_AGENT_NAME,
-    created: true
-  };
-}
-function recordsFromResponse(value) {
-  if (Array.isArray(value)) return value;
-  if (value && typeof value === "object" && Array.isArray(value.items)) {
-    return value.items;
-  }
-  return [];
-}
-function numberField(record, key) {
-  const value = record[key];
-  if (typeof value !== "number") throw new Error(`Expected numeric ${key}`);
-  return value;
-}
-function stringField(record, key) {
-  const value = record[key];
-  return typeof value === "string" ? value : "";
-}
 var AgentBuilder = class extends WorkspaceBuilderResource {
   constructor(name, options = {}) {
     super();
@@ -841,6 +858,7 @@ var AgentBuilder = class extends WorkspaceBuilderResource {
     this.tools = options.tools ?? [];
     this.codeInterpreterEnabled = options.codeInterpreterEnabled ?? options.code_interpreter_enabled ?? false;
   }
+  name;
   chatModelId;
   systemPrompt;
   memberRoleId;
@@ -892,6 +910,7 @@ var WorkspaceBuilder = class {
   constructor(client) {
     this.client = client;
   }
+  client;
   resources = [];
   form(name, options = {}) {
     const form = new FormBuilder(name, options.slug, options);
@@ -995,7 +1014,6 @@ ${"=".repeat(50)}`);
     await this.resolveExisting(resources);
     const summary = {};
     writeLine("Applying...");
-    await this.ensureWorkflowAgents(resources, summary);
     for (const resource of resources) {
       try {
         if (resource._existed) {
@@ -1016,7 +1034,7 @@ ${"=".repeat(50)}`);
           writeLine(`  Skipped: ${resource.planLine()}`);
         }
       } catch (err) {
-        writeLine(`  FAILED: ${resource.planLine()}: ${summarizeError(err)}`);
+        writeLine(formatApplyFailureLine(resource, err));
         throw new ApplyError(resource, err, summary);
       }
     }
@@ -1056,9 +1074,11 @@ Done! Created ${count} resources.`);
       }
     }
     if (!workflowNames.size) return;
-    for (const existing of await this.client.getWorkflows()) {
+    const existingWorkflows = await this.client.getWorkflows();
+    for (const { workflow: existing } of existingWorkflows.items) {
       if (existing.name && workflowNames.has(existing.name)) {
-        workflowNames.get(existing.name).adopt(existing);
+        const detail = await this.client.getWorkflow(existing.id);
+        workflowNames.get(existing.name).adopt(detail);
       }
     }
     const adoptedWorkflows = resources.filter(
@@ -1067,7 +1087,9 @@ Done! Created ${count} resources.`);
     if (!adoptedWorkflows.length) return;
     const existingTasks = await this.client.getTasks();
     for (const workflow of adoptedWorkflows) {
-      const workflowTasks = existingTasks.filter((task) => task.workflowId === workflow._id);
+      const workflowTasks = existingTasks.filter(
+        (task) => (task.workflowRevisionId ?? task.workflowId) === workflow._draftRevisionId
+      );
       const taskByName = new Map(workflowTasks.map((task) => [task.name, task]));
       for (const taskBuilder of workflow.tasks) {
         const match = taskByName.get(taskBuilder.name);
@@ -1089,21 +1111,6 @@ Done! Created ${count} resources.`);
       }
     }
   }
-  async ensureWorkflowAgents(resources, summary) {
-    const workflows = resources.filter(
-      (resource) => resource instanceof WorkflowBuilder && resource.needsDefaultAgent()
-    );
-    if (!workflows.length) return;
-    const agent = await getOrCreateDefaultWorkflowAgent(this.client);
-    for (const workflow of workflows) workflow.setAgentId(agent.id);
-    if (agent.created) {
-      summary.agents ??= [];
-      summary.agents.push(agent.id);
-      writeLine(`  Created Agent: ${agent.name} -> id=${agent.id}`);
-    } else {
-      writeLine(`  Using Agent: ${agent.name || agent.id} -> id=${agent.id}`);
-    }
-  }
   sortedResources() {
     const all = [];
     for (const resource of this.resources) {
@@ -1167,7 +1174,7 @@ Done! Created ${count} resources.`);
           {
             taskId,
             choicePrompt: transition.when,
-            celCondition: null,
+            celCondition: transition.celCondition ?? null,
             autoNext: transition.autoNext,
             required: transition.required
           }
@@ -1273,16 +1280,21 @@ Done! Created ${count} resources.`);
   }
 };
 var ApplyError = class extends Error {
+  createdSoFar;
+  #resource;
+  #cause;
   constructor(resource, cause, createdSoFar) {
-    super(
-      `Failed creating ${resource.planLine()}: ${summarizeError(cause)}
-Already created: ${JSON.stringify(
-        createdSoFar
-      )}`
-    );
-    this.resource = resource;
-    this.cause = cause;
+    super(formatApplyErrorMessage(resource, cause, createdSoFar));
+    this.name = "ApplyError";
     this.createdSoFar = createdSoFar;
+    this.#resource = resource;
+    this.#cause = cause;
+  }
+  get resource() {
+    return this.#resource;
+  }
+  get cause() {
+    return this.#cause;
   }
 };
 function resourceKey(resource) {
@@ -1303,7 +1315,7 @@ var SEARCHABLE_EVENT_RULE_SOURCE_FIELDS = [
   "taskId",
   "dataTypeId",
   "routineId",
-  "workflowId",
+  "workflowRevisionId",
   "journeyStepId"
 ];
 var EVENT_RULE_SOURCE_FIELDS = [
@@ -1393,8 +1405,64 @@ function handleEventRuleApplyFailure(resourceName, err) {
   writeLine(`  FAILED: Event rule on '${resourceName}': ${summary}`);
   throw new Error(`Failed wiring event rule on '${resourceName}': ${summary}`);
 }
+function writeScopeForResource(resource) {
+  if (resource instanceof FormBuilder) return "datatypes:write";
+  if (resource instanceof WorkflowBuilder || resource instanceof TaskBuilder) {
+    return "workflows:write";
+  }
+  if (resource instanceof AgentBuilder) return "agents:write";
+  if (resource instanceof MemberLabelBuilder || resource instanceof MemberFilterBuilder) {
+    return "members:write";
+  }
+  if (resource instanceof RoutineBuilder || resource instanceof NotificationRuleBuilder) {
+    return "automations:admin";
+  }
+  if (resource instanceof JourneyBuilder || resource instanceof JourneyStepBuilder) {
+    return "journeys:write";
+  }
+  if (resource instanceof RoleUpdate) return "member_roles:write";
+  return null;
+}
+function scopeRetryHint(resource) {
+  const scope = writeScopeForResource(resource);
+  return scope ? ` (retry exec with scopes=['${scope}'])` : "";
+}
+function formatApplyFailureLine(resource, err) {
+  const line = `  FAILED: ${resource.planLine()}: ${summarizeError(err)}`;
+  return hasStatus(err, 403) ? `${line}${scopeRetryHint(resource)}` : line;
+}
+function formatApplyErrorMessage(resource, cause, createdSoFar) {
+  let message = `Failed creating ${resource.planLine()}: ${summarizeError(cause)}`;
+  if (hasStatus(cause, 403)) {
+    const scope = writeScopeForResource(resource);
+    if (scope) {
+      message += `
+Retry exec with scopes=['${scope}']`;
+    }
+  }
+  const createdKeys = Object.keys(createdSoFar);
+  if (createdKeys.length > 0) {
+    message += `
+Already created: ${JSON.stringify(createdSoFar)}`;
+  }
+  return message;
+}
 function summarizeError(err) {
-  if (err instanceof Error) return err.name || "Error";
+  if (hasStatus(err, 403)) {
+    return "Insufficient permissions for this operation";
+  }
+  if (err instanceof ApiError) {
+    const msg = err.message.trim();
+    const availableTypesIdx = msg.indexOf("Available types:");
+    if (availableTypesIdx !== -1) {
+      const head = msg.slice(0, availableTypesIdx).trim().replace(/\.$/, "");
+      return head ? `${head}.` : "Request failed";
+    }
+    return msg.length > 240 ? `${msg.slice(0, 237)}...` : msg;
+  }
+  if (err instanceof Error) {
+    return err.name || "Error";
+  }
   return typeof err;
 }
 function hasStatus(err, status) {
@@ -1440,6 +1508,7 @@ export {
   CalendarScheduleAvailabilityType,
   CalendarScheduleRecurrence,
   CalendarSource,
+  CapabilityClass,
   ConsentMethod,
   CriterionType,
   DEFAULT_CHAT_MODEL,
@@ -1448,6 +1517,7 @@ export {
   DEFAULT_VOICE_INFERENCE_MODEL,
   DataCategory,
   DataFieldType,
+  DataRecordRetirementResponseReason,
   DataSensitivity,
   DataTypeRecordScope,
   DriverMode,
@@ -1471,6 +1541,9 @@ export {
   McpServerState,
   MemberFeature,
   MemberFilterBuilder,
+  MemberImportMatchInfoMatchType,
+  MemberImportPreviewRowAction,
+  MemberImportValidationError,
   MemberLabelBuilder,
   MemberType,
   MenuItemResponseItemType,
@@ -1493,7 +1566,12 @@ export {
   PERMISSION_NONE,
   PERMISSION_USE,
   PERMISSION_VERIFY,
+  PIDS_DISPOSITIONS,
+  PIDS_SOURCES,
+  POSITIVE_RATING_THRESHOLD,
   ProductType,
+  QUERY_VALUELESS_OPS,
+  QueriesApi,
   REALTIME_MODEL_CUSTOM,
   REALTIME_MODEL_GEMINI,
   REALTIME_MODEL_GEMINI_VERTEX,
@@ -1523,11 +1601,11 @@ export {
   TTS_MODEL_ELEVENLABS_FLASH,
   TTS_MODEL_ELEVENLABS_MULTILINGUAL,
   TTS_MODEL_ELEVENLABS_TURBO,
-  TTS_MODEL_POCKET,
   TTS_PREVIEW_PROVIDERS,
   TaskBuilder,
   TemplatesApi,
   ToolkitState,
+  WIDGET_SLUGS,
   WorkflowAccessWarningResourceType,
   WorkflowBuilder,
   WorkflowAccessWarningResourceType as WorkflowResourceType,
@@ -1553,12 +1631,14 @@ export {
   getFeaturesByVisibility,
   getMissingDependencies,
   getResourceMetadata,
+  getRevisionState,
   getScopeFromProductType,
   getTTSProvider,
   getVoiceModelId,
   initializeFeatures,
   isChatType,
   isFeatureAvailable,
+  isPositiveRating,
   isRegistryInitialized,
   isSMSDeliveryFailureStatus,
   requiresAssistantParticipant,