@getsupervisor/agents-studio-sdk 1.22.1 → 1.23.0

package/dist/index.cjs

@@ -27,6 +27,8 @@ __export(index_exports, {
   bindAgentPhones: () => bindAgentPhones,
   bindAgentSchedule: () => bindAgentSchedule,
   bindAgentScheduleExceptions: () => bindAgentScheduleExceptions,
+  bindAgentStageTriggers: () => bindAgentStageTriggers,
+  bindAgentStages: () => bindAgentStages,
   bindAgentTags: () => bindAgentTags,
   bindAgentVersions: () => bindAgentVersions,
   createAgentBlueprintsApi: () => createAgentBlueprintsApi,
@@ -35,6 +37,8 @@ __export(index_exports, {
   createAgentPhonesApi: () => createAgentPhonesApi,
   createAgentScheduleApi: () => createAgentScheduleApi,
   createAgentScheduleExceptionsApi: () => createAgentScheduleExceptionsApi,
+  createAgentStageTriggersApi: () => createAgentStageTriggersApi,
+  createAgentStagesApi: () => createAgentStagesApi,
   createAgentTagsApi: () => createAgentTagsApi,
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
@@ -560,6 +564,69 @@ function createAgentPhonesApi(cfg) {
   };
 }
 
+// src/api/agent-schedule-exceptions.ts
+function createAgentScheduleExceptionsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  const fetchExceptionsPage = async (agentId, options = {}) => {
+    const query = serializeListOptions(options ?? {});
+    const res = await doFetch(`${base}/agents/${agentId}/schedule/exceptions`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(agentId, options = {}) {
+      const normalizedOptions = {
+        ...options ?? {}
+      };
+      const fetchPage = (pageOptions) => fetchExceptionsPage(agentId, pageOptions);
+      const response = await fetchPage(normalizedOptions);
+      return attachPaginator(response, fetchPage, normalizedOptions);
+    },
+    async get(agentId, exceptionId) {
+      const res = await doFetch(
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        {
+          method: "GET"
+        }
+      );
+      return res.json();
+    },
+    async create(agentId, payload) {
+      const res = await doFetch(
+        `${base}/agents/${agentId}/schedule/exceptions`,
+        {
+          method: "POST",
+          headers: jsonHeaders,
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
+    },
+    async update(agentId, exceptionId, payload) {
+      const res = await doFetch(
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        {
+          method: "PATCH",
+          headers: jsonHeaders,
+          body: JSON.stringify(payload)
+        }
+      );
+      return res.json();
+    },
+    async delete(agentId, exceptionId) {
+      await doFetch(
+        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        {
+          method: "DELETE"
+        }
+      );
+    }
+  };
+}
+
 // src/api/agent-schedule.ts
 function createAgentScheduleApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -590,39 +657,52 @@ function createAgentScheduleApi(cfg) {
   };
 }
 
-// src/api/agent-schedule-exceptions.ts
-function createAgentScheduleExceptionsApi(cfg) {
+// src/api/agent-stage-triggers.ts
+function createAgentStageTriggersApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
   const jsonHeaders = { "content-type": "application/json" };
-  const fetchExceptionsPage = async (agentId, options = {}) => {
-    const query = serializeListOptions(options ?? {});
-    const res = await doFetch(`${base}/agents/${agentId}/schedule/exceptions`, {
-      method: "GET",
-      query
-    });
+  const fetchTriggerPage = async (agentId, stageId, options = {}) => {
+    const normalizedOptions = {
+      page: options.page,
+      limit: options.limit,
+      sort: options.sort,
+      fields: options.fields,
+      include: options.include,
+      filter: options.filter,
+      search: options.search,
+      or: options.or
+    };
+    const query = serializeListOptions(normalizedOptions);
+    const res = await doFetch(
+      `${base}/agents/${agentId}/stages/${stageId}/triggers`,
+      {
+        method: "GET",
+        query
+      }
+    );
     return res.json();
   };
   return {
-    async list(agentId, options = {}) {
-      const normalizedOptions = {
+    async list(agentId, stageId, options = {}) {
+      const normalized = {
         ...options ?? {}
       };
-      const fetchPage = (pageOptions) => fetchExceptionsPage(agentId, pageOptions);
-      const response = await fetchPage(normalizedOptions);
-      return attachPaginator(response, fetchPage, normalizedOptions);
+      const fetchPage = (opts) => fetchTriggerPage(agentId, stageId, opts);
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
     },
-    async get(agentId, exceptionId) {
+    async get(agentId, stageId, triggerId) {
       const res = await doFetch(
-        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/stages/${stageId}/triggers/${triggerId}`,
         {
           method: "GET"
         }
       );
       return res.json();
     },
-    async create(agentId, payload) {
+    async create(agentId, stageId, payload) {
       const res = await doFetch(
-        `${base}/agents/${agentId}/schedule/exceptions`,
+        `${base}/agents/${agentId}/stages/${stageId}/triggers`,
         {
           method: "POST",
           headers: jsonHeaders,
@@ -631,9 +711,9 @@ function createAgentScheduleExceptionsApi(cfg) {
       );
       return res.json();
     },
-    async update(agentId, exceptionId, payload) {
+    async update(agentId, stageId, triggerId, payload) {
       const res = await doFetch(
-        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/stages/${stageId}/triggers/${triggerId}`,
         {
           method: "PATCH",
           headers: jsonHeaders,
@@ -642,9 +722,9 @@ function createAgentScheduleExceptionsApi(cfg) {
       );
       return res.json();
     },
-    async delete(agentId, exceptionId) {
+    async delete(agentId, stageId, triggerId) {
       await doFetch(
-        `${base}/agents/${agentId}/schedule/exceptions/${exceptionId}`,
+        `${base}/agents/${agentId}/stages/${stageId}/triggers/${triggerId}`,
         {
           method: "DELETE"
         }
@@ -653,6 +733,70 @@ function createAgentScheduleExceptionsApi(cfg) {
   };
 }
 
+// src/api/agent-stages.ts
+function createAgentStagesApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  const fetchStagePage = async (agentId, options = {}) => {
+    const normalizedOptions = {
+      page: options.page,
+      limit: options.limit,
+      sort: options.sort,
+      filter: options.filter,
+      search: options.search
+    };
+    const query = serializeListOptions(normalizedOptions);
+    const res = await doFetch(`${base}/agents/${agentId}/stages`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  return {
+    async list(agentId, options = {}) {
+      const normalized = { ...options ?? {} };
+      const fetchPage = (opts) => fetchStagePage(agentId, opts);
+      const response = await fetchPage(normalized);
+      return attachPaginator(response, fetchPage, normalized);
+    },
+    async get(agentId, stageId) {
+      const res = await doFetch(`${base}/agents/${agentId}/stages/${stageId}`, {
+        method: "GET"
+      });
+      return res.json();
+    },
+    async create(agentId, payload) {
+      const res = await doFetch(`${base}/agents/${agentId}/stages`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async update(agentId, stageId, payload) {
+      const res = await doFetch(`${base}/agents/${agentId}/stages/${stageId}`, {
+        method: "PATCH",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async delete(agentId, stageId) {
+      await doFetch(`${base}/agents/${agentId}/stages/${stageId}`, {
+        method: "DELETE"
+      });
+    },
+    async reorder(agentId, payload) {
+      const res = await doFetch(`${base}/agents/${agentId}/stages:reorder`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    }
+  };
+}
+
 // src/api/agent-tags.ts
 function createAgentTagsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -805,6 +949,46 @@ var bindAgentInstructions = (api, agentId) => ({
     return api.delete(agentId, instructionId);
   }
 });
+var bindAgentStageTriggers = (api, agentId, stageId) => ({
+  list(opts) {
+    return api.list(agentId, stageId, opts);
+  },
+  get(triggerId) {
+    return api.get(agentId, stageId, triggerId);
+  },
+  create(payload) {
+    return api.create(agentId, stageId, payload);
+  },
+  update(triggerId, payload) {
+    return api.update(agentId, stageId, triggerId, payload);
+  },
+  delete(triggerId) {
+    return api.delete(agentId, stageId, triggerId);
+  }
+});
+var bindAgentStages = (stagesApi, triggersApi, agentId) => ({
+  list(opts) {
+    return stagesApi.list(agentId, opts);
+  },
+  get(stageId) {
+    return stagesApi.get(agentId, stageId);
+  },
+  create(payload) {
+    return stagesApi.create(agentId, payload);
+  },
+  update(stageId, payload) {
+    return stagesApi.update(agentId, stageId, payload);
+  },
+  delete(stageId) {
+    return stagesApi.delete(agentId, stageId);
+  },
+  reorder(payload) {
+    return stagesApi.reorder(agentId, payload);
+  },
+  triggers(stageId) {
+    return bindAgentStageTriggers(triggersApi, agentId, stageId);
+  }
+});
 var bindAgentTags = (api, agentId) => ({
   add(tagId) {
     return api.add(agentId, { tagId });
@@ -918,6 +1102,8 @@ var createAgentEntity = (dto, options) => {
     scheduleExceptionsApi,
     versionsApi,
     blueprintsApi,
+    stagesApi,
+    stageTriggersApi,
     reload,
     updateAgent,
     deleteAgent
@@ -934,6 +1120,7 @@ var createAgentEntity = (dto, options) => {
     ),
     versions: bindAgentVersions(versionsApi, dto.agentId),
     blueprints: bindAgentBlueprints(blueprintsApi, dto.agentId),
+    stages: bindAgentStages(stagesApi, stageTriggersApi, dto.agentId),
     async save(patch) {
       return updateAgent(dto.agentId, patch);
     },
@@ -1018,6 +1205,8 @@ function createAgentsApi(cfg, relatedApis) {
     scheduleExceptionsApi: relatedApis.scheduleExceptionsApi,
     versionsApi: relatedApis.versionsApi,
     blueprintsApi: relatedApis.blueprintsApi,
+    stagesApi: relatedApis.stagesApi,
+    stageTriggersApi: relatedApis.stageTriggersApi,
     reload: async (agentId) => {
       const latest = await getAgentDetail(agentId);
       return wrapAgent(latest);
@@ -1268,21 +1457,167 @@ function createToolsApi(cfg) {
   };
 }
 
+// src/utils/catalog-voices.ts
+var FALLBACK_LOCALE = "und";
+var FALLBACK_PROVIDER = "catalog";
+function catalogItemToVoice(item) {
+  const metadata = normalizeVoiceMetadata(item.metadata);
+  const locale = metadata.locale ?? metadata.language ?? FALLBACK_LOCALE;
+  return {
+    id: item.id,
+    providerVoiceId: metadata.providerVoiceId ?? item.systemIdentifier,
+    name: item.name,
+    gender: metadata.gender,
+    locale,
+    tags: metadata.tags ?? [],
+    previewUrl: metadata.previewUrl ?? void 0,
+    provider: metadata.provider ?? FALLBACK_PROVIDER
+  };
+}
+function normalizeVoiceMetadata(metadata) {
+  if (!metadata || typeof metadata !== "object") {
+    return {};
+  }
+  const raw = metadata;
+  return {
+    language: pickString(raw.language),
+    locale: pickString(raw.locale, true),
+    gender: pickGender(raw.gender),
+    provider: pickString(raw.provider, true),
+    previewUrl: pickString(raw.previewUrl, true),
+    tags: pickStringArray(raw.tags),
+    providerVoiceId: pickString(raw.providerVoiceId)
+  };
+}
+function pickString(value, allowNull = false) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (allowNull && value === null) {
+    return null;
+  }
+  return void 0;
+}
+function pickStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const items = value.filter(
+    (item) => typeof item === "string"
+  );
+  return items.length > 0 ? items : void 0;
+}
+function pickGender(value) {
+  if (value === "female" || value === "male" || value === "neutral") {
+    return value;
+  }
+  return void 0;
+}
+
+// src/utils/catalog-filter.ts
+var import_api_query_builder = require("@getsupervisor/api-query-builder");
+function createCatalogTypeQuery(type) {
+  return new import_api_query_builder.Query((qb) => qb.eq("type", type));
+}
+function ensureCatalogTypeFilter(filter, type) {
+  const requiredQuery = createCatalogTypeQuery(type);
+  const requiredExpression = requiredQuery.build();
+  if (filter === void 0 || filter === null) {
+    return requiredQuery;
+  }
+  if (typeof filter === "string") {
+    return ensureTypeForString(filter, requiredQuery, requiredExpression);
+  }
+  if (isQueryBuilderLike(filter)) {
+    return ensureTypeForBuilder(filter, requiredQuery, requiredExpression);
+  }
+  if (isPlainObject2(filter)) {
+    return ensureTypeForObject(filter, type);
+  }
+  return filter;
+}
+function ensureTypeForString(value, requiredQuery, requiredExpression) {
+  const normalized = value.trim();
+  if (!normalized.length) {
+    return requiredQuery;
+  }
+  return containsTypePredicate(normalized, requiredExpression) ? normalized : `and(${requiredExpression},${normalized})`;
+}
+function ensureTypeForBuilder(builder, requiredQuery, requiredExpression) {
+  const normalized = builder.build().trim();
+  if (!normalized.length) {
+    return requiredQuery;
+  }
+  if (containsTypePredicate(normalized, requiredExpression)) {
+    return builder;
+  }
+  const combined = `and(${requiredExpression},${normalized})`;
+  return {
+    build: () => combined
+  };
+}
+function ensureTypeForObject(candidate, type) {
+  if (hasTypeEquality(candidate, type)) {
+    return candidate;
+  }
+  const typeConfig = candidate.type;
+  const normalizedType = isPlainObject2(typeConfig) ? { ...typeConfig, eq: type } : { eq: type };
+  return {
+    ...candidate,
+    type: normalizedType
+  };
+}
+function hasTypeEquality(candidate, type) {
+  const typeConfig = candidate.type;
+  if (typeof typeConfig === "string") {
+    return typeConfig === type;
+  }
+  if (!isPlainObject2(typeConfig)) {
+    return false;
+  }
+  return typeConfig.eq === type;
+}
+function containsTypePredicate(expression, required) {
+  const normalizedExpression = expression.replace(/\s+/g, "").toLowerCase();
+  const normalizedRequired = required.replace(/\s+/g, "").toLowerCase();
+  return normalizedExpression.includes(normalizedRequired);
+}
+function isQueryBuilderLike(candidate) {
+  return !!candidate && typeof candidate === "object" && typeof candidate.build === "function";
+}
+function isPlainObject2(value) {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+
 // src/api/voices.ts
+function mapCatalogResponseToVoiceList(response) {
+  return {
+    data: response.data.filter((item) => item.type === "voice").map(catalogItemToVoice),
+    meta: response.meta
+  };
+}
 function createVoicesApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
   const fetchVoicesPage = async (options = {}) => {
-    const { agentId, agentVersionId, gender, locale } = options;
+    const normalizedOptions = {
+      ...options,
+      filter: ensureCatalogTypeFilter(options.filter, "voice")
+    };
+    const { agentId, agentVersionId, gender, locale } = normalizedOptions;
     const query = serializeListOptions(
       {
-        page: options.page,
-        limit: options.limit ?? options.pageSize,
-        sort: options.sort,
-        fields: options.fields,
-        include: options.include,
-        search: options.search,
-        filter: options.filter,
-        or: options.or
+        page: normalizedOptions.page,
+        limit: normalizedOptions.limit ?? normalizedOptions.pageSize,
+        sort: normalizedOptions.sort,
+        fields: normalizedOptions.fields,
+        include: normalizedOptions.include,
+        search: normalizedOptions.search,
+        filter: normalizedOptions.filter,
+        or: normalizedOptions.or
       },
       {
         agentId,
@@ -1291,11 +1626,12 @@ function createVoicesApi(cfg) {
         locale
       }
     );
-    const res = await doFetch(`${base}/voices`, {
+    const res = await doFetch(`${base}/catalogs/items`, {
       method: "GET",
       query
     });
-    return res.json();
+    const raw = await res.json();
+    return mapCatalogResponseToVoiceList(raw);
   };
   return {
     async list(options = {}) {
@@ -1492,6 +1828,8 @@ function createClient(initialCfg) {
   const scheduleExceptionsApi = createAgentScheduleExceptionsApi(runtimeCfg);
   const versionsApi = createAgentVersionsApi(runtimeCfg);
   const blueprintsApi = createAgentBlueprintsApi(runtimeCfg);
+  const stageTriggersApi = createAgentStageTriggersApi(runtimeCfg);
+  const stagesApi = createAgentStagesApi(runtimeCfg);
   const voicesApi = createVoicesApi(runtimeCfg);
   const apiKeysApi = createApiKeysApi(runtimeCfg);
   const catalogsApi = createCatalogsApi(runtimeCfg);
@@ -1503,7 +1841,9 @@ function createClient(initialCfg) {
     scheduleApi,
     scheduleExceptionsApi,
     versionsApi,
-    blueprintsApi
+    blueprintsApi,
+    stagesApi,
+    stageTriggersApi
   });
   const instructionsNamespace = Object.assign(
     (agentId) => bindAgentInstructions(instructionsApi, agentId),
@@ -1536,6 +1876,17 @@ function createClient(initialCfg) {
     (agentId) => bindAgentBlueprints(blueprintsApi, agentId),
     blueprintsApi
   );
+  const stageTriggersNamespace = Object.assign(
+    (agentId, stageId) => bindAgentStageTriggers(stageTriggersApi, agentId, stageId),
+    stageTriggersApi
+  );
+  const stagesNamespace = Object.assign(
+    (agentId) => bindAgentStages(stagesApi, stageTriggersApi, agentId),
+    {
+      ...stagesApi,
+      triggers: stageTriggersNamespace
+    }
+  );
   const apis = {
     agents: {
       ...agentsApi,
@@ -1544,7 +1895,8 @@ function createClient(initialCfg) {
       phones: phonesNamespace,
       schedule: scheduleNamespace,
       versions: versionsNamespace,
-      blueprints: blueprintsNamespace
+      blueprints: blueprintsNamespace,
+      stages: stagesNamespace
     },
     workspaces: createWorkspacesApi(runtimeCfg),
     tools: createToolsApi(runtimeCfg),
@@ -1618,6 +1970,8 @@ function createClient(initialCfg) {
   bindAgentPhones,
   bindAgentSchedule,
   bindAgentScheduleExceptions,
+  bindAgentStageTriggers,
+  bindAgentStages,
   bindAgentTags,
   bindAgentVersions,
   createAgentBlueprintsApi,
@@ -1626,6 +1980,8 @@ function createClient(initialCfg) {
   createAgentPhonesApi,
   createAgentScheduleApi,
   createAgentScheduleExceptionsApi,
+  createAgentStageTriggersApi,
+  createAgentStagesApi,
   createAgentTagsApi,
   createAgentVersionsApi,
   createAgentsApi,