@getsupervisor/agents-studio-sdk 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## v1.10.0
+
+## [1.10.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.9.0...v1.10.0) (2025-10-17)
+
+### Features
+
+* **badges:** agregar archivo SVG de badge de cobertura ([9a880d4](https://github.com/julio-supervisor/agents-studio-be/commit/9a880d4e5f6983ab441aa04371ee5c49ee69de16))
+* **ci:** add coverage badge generation and update README with coverage metrics ([ce21547](https://github.com/julio-supervisor/agents-studio-be/commit/ce21547440a70536fb461526dc8673c8e91ca1fc))
+* **ci:** add NODE_AUTH_TOKEN build argument for Docker image ([5711a10](https://github.com/julio-supervisor/agents-studio-be/commit/5711a106667262e83b3598c71a7aa85b7468d3d2))
+* **ci:** update coverage badge generation and enhance README with CI badges ([f65f7df](https://github.com/julio-supervisor/agents-studio-be/commit/f65f7df6d6eb40f401bbee0e9c9cc25dbce98476))
+* **instructions:** implement instruction management module ([48f2a5e](https://github.com/julio-supervisor/agents-studio-be/commit/48f2a5e6549606707b2571a0844d433d8b8a8dc9))
+
+### Bug Fixes
+
+* **ci:** update coverage badge generation action and README to reflect new badge path ([0ba765c](https://github.com/julio-supervisor/agents-studio-be/commit/0ba765c67c7bba37aa5fbb2f75f0e0eb2d53cd93))
+* **ci:** update coverage badge generation paths for consistency ([fec0e57](https://github.com/julio-supervisor/agents-studio-be/commit/fec0e57bd7e1f2e9de01058da89271b0a542a7b4))
+* **docs:** actualizar descripciones de instrucciones en la especificación OpenAPI ([5f8a36f](https://github.com/julio-supervisor/agents-studio-be/commit/5f8a36f9ceab3b39d6f81a51ef9500d33eb5713a))
+* **docs:** corregir la ruta del badge de cobertura en el README ([049c28f](https://github.com/julio-supervisor/agents-studio-be/commit/049c28fa4323f82b43616d92fd262309f8d84efa))
+
+
 ## v1.9.0
 
 ## [1.9.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.8.0...v1.9.0) (2025-10-16)

package/README.md

@@ -32,6 +32,29 @@ await client.agents
   .instructions('version-1')
   .create({ order: 1, content: 'Saluda con empatía' });
 
+// administrar blueprints por versión
+const blueprints = client.agents.blueprints(agent.agentId);
+await blueprints
+  .version('version-1')
+  .create({
+    languageId: 'es-MX',
+    personalityName: 'Embajador de marca',
+    personalityRole: 'Consultor de adopción',
+    targetAudience: 'Usuarios nuevos',
+    mainGoal: 'Incrementar la activación',
+    personalityInitialGreeting: '¡Hola! Soy tu asistente de onboarding.',
+    personalityMessageStyleId: 'style-uuid',
+    personalityToneStyleId: 'tone-uuid',
+    requiredData: [{ key: 'industry', label: 'Industria' }],
+    criticalRules: ['Nunca compartas precios internos'],
+    topicsAllowed: ['onboarding', 'soporte'],
+    topicsForbidden: ['facturación'],
+  });
+
+// los helpers del entity también exponen blueprints
+const agentBlueprint = await agent.blueprints.version('version-1').get();
+console.log(agentBlueprint.personalityName);
+
 // catálogo y recursos de tools
 const tools = await client.tools.list({ agentType: 'chat' });
 await client.tools.uploadResource(tools.data[0].identifier, formData);

package/dist/index.cjs

@@ -22,11 +22,13 @@ __export(index_exports, {
   HttpError: () => HttpError,
   NetworkError: () => NetworkError,
   TimeoutError: () => TimeoutError,
+  bindAgentBlueprints: () => bindAgentBlueprints,
   bindAgentInstructions: () => bindAgentInstructions,
   bindAgentPhones: () => bindAgentPhones,
   bindAgentSchedule: () => bindAgentSchedule,
   bindAgentTags: () => bindAgentTags,
   bindAgentVersions: () => bindAgentVersions,
+  createAgentBlueprintsApi: () => createAgentBlueprintsApi,
   createAgentEntity: () => createAgentEntity,
   createAgentInstructionsApi: () => createAgentInstructionsApi,
   createAgentPhonesApi: () => createAgentPhonesApi,
@@ -42,98 +44,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/utils/pagination.ts
-var toNumber = (value) => {
-  return typeof value === "number" ? value : void 0;
-};
-var toBoolean = (value) => {
-  return typeof value === "boolean" ? value : void 0;
-};
-function cloneOptions(options, overrides) {
-  return {
-    ...options ?? {},
-    ...overrides ?? {}
-  };
-}
-function normalizeMeta(meta) {
-  if (!meta) {
-    return void 0;
-  }
-  const metaRecord = meta;
-  return {
-    ...metaRecord,
-    page: toNumber(metaRecord.page),
-    limit: toNumber(metaRecord.limit) ?? toNumber(metaRecord.pageSize),
-    total: toNumber(metaRecord.total) ?? toNumber(metaRecord.totalItems),
-    hasNext: toBoolean(metaRecord.hasNext),
-    hasPrevious: toBoolean(metaRecord.hasPrevious),
-    totalPages: toNumber(metaRecord.totalPages)
-  };
-}
-function resolveHasNext(meta, limit) {
-  if (typeof meta?.hasNext === "boolean") {
-    return meta.hasNext;
-  }
-  if (typeof meta?.total === "number" && typeof meta?.page === "number" && typeof limit === "number") {
-    return meta.page * limit < meta.total;
-  }
-  if (typeof meta?.totalPages === "number" && typeof meta?.page === "number") {
-    return meta.page < meta.totalPages;
-  }
-  return false;
-}
-function resolveHasPrevious(meta) {
-  if (typeof meta?.hasPrevious === "boolean") {
-    return meta.hasPrevious;
-  }
-  if (typeof meta?.page === "number") {
-    return meta.page > 1;
-  }
-  return false;
-}
-function attachPaginator(response, fetchPage, options) {
-  const baseOptions = options ?? {};
-  const meta = normalizeMeta(response.meta);
-  const currentPage = typeof meta?.page === "number" ? meta.page : typeof baseOptions.page === "number" ? baseOptions.page : 1;
-  const currentLimit = typeof meta?.limit === "number" ? meta.limit : typeof baseOptions.limit === "number" ? baseOptions.limit : void 0;
-  const getNextResponse = async (page, overrides) => {
-    const nextOptions = cloneOptions(baseOptions, {
-      ...overrides,
-      page
-    });
-    const nextResponse = await fetchPage(nextOptions);
-    return attachPaginator(nextResponse, fetchPage, nextOptions);
-  };
-  return Object.assign(response, {
-    async next() {
-      if (!resolveHasNext(meta, currentLimit)) {
-        return null;
-      }
-      return getNextResponse(currentPage + 1);
-    },
-    async prev() {
-      if (!resolveHasPrevious(meta)) {
-        return null;
-      }
-      return getNextResponse(Math.max(1, currentPage - 1));
-    },
-    async page(pageNumber) {
-      if (typeof pageNumber !== "number" || Number.isNaN(pageNumber)) {
-        throw new TypeError("page(pageNumber) requires a numeric value.");
-      }
-      if (pageNumber < 1) {
-        throw new RangeError(
-          "Page numbers must be greater than or equal to 1."
-        );
-      }
-      return getNextResponse(pageNumber);
-    },
-    async reload() {
-      return getNextResponse(currentPage);
-    }
-  });
-}
-
 // src/errors.ts
 var HttpError = class extends Error {
   constructor(status, statusText, body, url) {
@@ -424,6 +334,149 @@ function getQueryBuilderString(value) {
   return String(result);
 }
 
+// src/api/agent-blueprints.ts
+function createAgentBlueprintsApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  const list = async (agentId, options = {}) => {
+    const query = serializeListOptions({ filter: options.filter });
+    const res = await doFetch(`${base}/v1/agents/${agentId}/blueprints`, {
+      method: "GET",
+      query
+    });
+    return res.json();
+  };
+  const get = async (agentId, versionId) => {
+    const res = await doFetch(
+      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      {
+        method: "GET"
+      }
+    );
+    return res.json();
+  };
+  const create = async (agentId, versionId, payload) => {
+    const res = await doFetch(
+      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      {
+        method: "POST",
+        body: JSON.stringify(payload),
+        headers: jsonHeaders
+      }
+    );
+    return res.json();
+  };
+  const update = async (agentId, versionId, payload) => {
+    const res = await doFetch(
+      `${base}/v1/agents/${agentId}/versions/${versionId}/blueprint`,
+      {
+        method: "PATCH",
+        body: JSON.stringify(payload),
+        headers: jsonHeaders
+      }
+    );
+    return res.json();
+  };
+  return {
+    list,
+    get,
+    create,
+    update
+  };
+}
+
+// src/utils/pagination.ts
+var toNumber = (value) => {
+  return typeof value === "number" ? value : void 0;
+};
+var toBoolean = (value) => {
+  return typeof value === "boolean" ? value : void 0;
+};
+function cloneOptions(options, overrides) {
+  return {
+    ...options ?? {},
+    ...overrides ?? {}
+  };
+}
+function normalizeMeta(meta) {
+  if (!meta) {
+    return void 0;
+  }
+  const metaRecord = meta;
+  return {
+    ...metaRecord,
+    page: toNumber(metaRecord.page),
+    limit: toNumber(metaRecord.limit) ?? toNumber(metaRecord.pageSize),
+    total: toNumber(metaRecord.total) ?? toNumber(metaRecord.totalItems),
+    hasNext: toBoolean(metaRecord.hasNext),
+    hasPrevious: toBoolean(metaRecord.hasPrevious),
+    totalPages: toNumber(metaRecord.totalPages)
+  };
+}
+function resolveHasNext(meta, limit) {
+  if (typeof meta?.hasNext === "boolean") {
+    return meta.hasNext;
+  }
+  if (typeof meta?.total === "number" && typeof meta?.page === "number" && typeof limit === "number") {
+    return meta.page * limit < meta.total;
+  }
+  if (typeof meta?.totalPages === "number" && typeof meta?.page === "number") {
+    return meta.page < meta.totalPages;
+  }
+  return false;
+}
+function resolveHasPrevious(meta) {
+  if (typeof meta?.hasPrevious === "boolean") {
+    return meta.hasPrevious;
+  }
+  if (typeof meta?.page === "number") {
+    return meta.page > 1;
+  }
+  return false;
+}
+function attachPaginator(response, fetchPage, options) {
+  const baseOptions = options ?? {};
+  const meta = normalizeMeta(response.meta);
+  const currentPage = typeof meta?.page === "number" ? meta.page : typeof baseOptions.page === "number" ? baseOptions.page : 1;
+  const currentLimit = typeof meta?.limit === "number" ? meta.limit : typeof baseOptions.limit === "number" ? baseOptions.limit : void 0;
+  const getNextResponse = async (page, overrides) => {
+    const nextOptions = cloneOptions(baseOptions, {
+      ...overrides,
+      page
+    });
+    const nextResponse = await fetchPage(nextOptions);
+    return attachPaginator(nextResponse, fetchPage, nextOptions);
+  };
+  return Object.assign(response, {
+    async next() {
+      if (!resolveHasNext(meta, currentLimit)) {
+        return null;
+      }
+      return getNextResponse(currentPage + 1);
+    },
+    async prev() {
+      if (!resolveHasPrevious(meta)) {
+        return null;
+      }
+      return getNextResponse(Math.max(1, currentPage - 1));
+    },
+    async page(pageNumber) {
+      if (typeof pageNumber !== "number" || Number.isNaN(pageNumber)) {
+        throw new TypeError("page(pageNumber) requires a numeric value.");
+      }
+      if (pageNumber < 1) {
+        throw new RangeError(
+          "Page numbers must be greater than or equal to 1."
+        );
+      }
+      return getNextResponse(pageNumber);
+    },
+    async reload() {
+      return getNextResponse(currentPage);
+    }
+  });
+}
+
 // src/api/agent-instructions.ts
 function createAgentInstructionsApi(cfg) {
   const { base, doFetch } = createHttp(cfg);
@@ -714,6 +767,24 @@ var bindAgentVersions = (api, agentId) => ({
     };
   }
 });
+var bindAgentBlueprints = (api, agentId) => ({
+  list(opts) {
+    return api.list(agentId, opts);
+  },
+  version(versionId) {
+    return {
+      get() {
+        return api.get(agentId, versionId);
+      },
+      create(payload) {
+        return api.create(agentId, versionId, payload);
+      },
+      update(payload) {
+        return api.update(agentId, versionId, payload);
+      }
+    };
+  }
+});
 var createAgentEntity = (dto, options) => {
   const {
     instructionsApi,
@@ -721,6 +792,7 @@ var createAgentEntity = (dto, options) => {
     phonesApi,
     scheduleApi,
     versionsApi,
+    blueprintsApi,
     reload,
     updateAgent,
     deleteAgent
@@ -732,6 +804,7 @@ var createAgentEntity = (dto, options) => {
     phones: bindAgentPhones(phonesApi, dto.agentId),
     schedule: bindAgentSchedule(scheduleApi, dto.agentId),
     versions: bindAgentVersions(versionsApi, dto.agentId),
+    blueprints: bindAgentBlueprints(blueprintsApi, dto.agentId),
     async save(patch) {
       return updateAgent(dto.agentId, patch);
     },
@@ -814,6 +887,7 @@ function createAgentsApi(cfg, relatedApis) {
     phonesApi: relatedApis.phonesApi,
     scheduleApi: relatedApis.scheduleApi,
     versionsApi: relatedApis.versionsApi,
+    blueprintsApi: relatedApis.blueprintsApi,
     reload: async (agentId) => {
       const latest = await getAgentDetail(agentId);
       return wrapAgent(latest);
@@ -1065,13 +1139,15 @@ function createClient(initialCfg) {
   const phonesApi = createAgentPhonesApi(runtimeCfg);
   const scheduleApi = createAgentScheduleApi(runtimeCfg);
   const versionsApi = createAgentVersionsApi(runtimeCfg);
+  const blueprintsApi = createAgentBlueprintsApi(runtimeCfg);
   const voicesApi = createVoicesApi(runtimeCfg);
   const agentsApi = createAgentsApi(runtimeCfg, {
     instructionsApi,
     tagsApi,
     phonesApi,
     scheduleApi,
-    versionsApi
+    versionsApi,
+    blueprintsApi
   });
   const instructionsNamespace = Object.assign(
     (agentId) => bindAgentInstructions(instructionsApi, agentId),
@@ -1093,6 +1169,10 @@ function createClient(initialCfg) {
     (agentId) => bindAgentVersions(versionsApi, agentId),
     versionsApi
   );
+  const blueprintsNamespace = Object.assign(
+    (agentId) => bindAgentBlueprints(blueprintsApi, agentId),
+    blueprintsApi
+  );
   const apis = {
     agents: {
       ...agentsApi,
@@ -1100,7 +1180,8 @@ function createClient(initialCfg) {
       tags: tagsNamespace,
       phones: phonesNamespace,
       schedule: scheduleNamespace,
-      versions: versionsNamespace
+      versions: versionsNamespace,
+      blueprints: blueprintsNamespace
     },
     workspaces: createWorkspacesApi(runtimeCfg),
     tools: createToolsApi(runtimeCfg),
@@ -1152,11 +1233,13 @@ function createClient(initialCfg) {
   HttpError,
   NetworkError,
   TimeoutError,
+  bindAgentBlueprints,
   bindAgentInstructions,
   bindAgentPhones,
   bindAgentSchedule,
   bindAgentTags,
   bindAgentVersions,
+  createAgentBlueprintsApi,
   createAgentEntity,
   createAgentInstructionsApi,
   createAgentPhonesApi,