@getsupervisor/agents-studio-sdk 1.10.0 → 1.12.0

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## v1.11.0
+
+## [1.11.0](https://github.com/julio-supervisor/agents-studio-be/compare/v1.10.0...v1.11.0) (2025-10-19)
+
+### Features
+
+* **agent-blueprints:** add module implementation and tests ([d631ce5](https://github.com/julio-supervisor/agents-studio-be/commit/d631ce59cf439306020d7e06fe561a808d1f2753))
+* **blueprints:** implement agent blueprints API and integrate with client ([d166104](https://github.com/julio-supervisor/agents-studio-be/commit/d166104f04951d434f5cf89d068babff76ceb42d))
+
+
+## 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);
@@ -100,60 +123,77 @@ await scoped.agents.get('agentId');
 
 ## Gestión de API Keys
 
-Los endpoints `/v1/api-keys` permiten listar, crear y revocar credenciales por workspace. Mientras publicamos helpers específicos en el cliente, puedes usar la utilidad `createHttp` para firmar peticiones con el mismo manejo de cabeceras, timeouts y reintentos del SDK.
+Los endpoints `/v1/api-keys` permiten listar, crear y revocar credenciales por workspace. Desde la versión 1.10 el SDK expone un namespace dedicado para gestionar el ciclo de vida completo de las claves sin escribir boilerplate adicional.
 
 > También puedes consumir el CRUD de agentes con API Keys pasando `apiKey` a `createClient` o usando `client.auth.setApiKey('sk_...')`. El SDK enviará el header `X-API-Key` automáticamente en cada llamada.
 
+### Cliente dedicado: `client.apiKeys`
+
 ```ts
-import { createHttp } from '@getsupervisor/agents-studio-sdk';
+import { createClient } from '@getsupervisor/agents-studio-sdk';
 
-const http = createHttp({
+const client = createClient({
   baseUrl: 'https://public-api.getsupervisor.ai',
   headers: { Authorization: `Bearer ${token}` },
   workspaceId: 'ws-123',
 });
-```
 
-### Listar API Keys activas
+// 1. Listar credenciales activas
+const keys = await client.apiKeys.list();
 
-```ts
-const res = await http.doFetch(`${http.base}/v1/api-keys`, { method: 'GET' });
-const apiKeys = await res.json();
+// 2. Emitir una nueva credencial (recuerda guardar el valor completo)
+const created = await client.apiKeys.create({
+  name: 'Backend Integration',
+  environment: 'production',
+  scopes: ['agents:read', 'api-keys:read'],
+});
+console.log(created.key); // sólo se entrega una vez
 
-// apiKeys: ApiKeySummary[]
+// 3. Revelar el valor completo cuando necesites consultarlo de nuevo
+const revealed = await client.apiKeys.show(created.id);
+console.log(revealed.key); // también incluye metadatos actualizados
+
+// 4. Revocar cuando deje de ser necesaria
+await client.apiKeys.revoke(created.id);
 ```
 
-Cada entrada incluye `id`, `name`, `environment`, `scopes`, fechas de auditoría y un `keyPreview` para validar qué credencial usas en producción o sandbox.
+Cada entrada (`ApiKeySummary`) incluye `id`, `name`, `environment`, `scopes`, fechas de auditoría y un `keyPreview` para identificar la credencial sin exponerla por completo.
+
+### Usar API Keys dinámicas
 
-### Crear una API Key con scopes personalizados
+Puedes rotar claves en caliente con los helpers de autenticación:
 
 ```ts
-const res = await http.doFetch(`${http.base}/v1/api-keys`, {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({
-    name: 'Backend Integration',
-    description: 'Sincronización nocturna de métricas',
-    environment: 'production',
-    scopes: ['agents:read', 'api-keys:read'],
-  }),
-});
+client.auth.setApiKey('sk_prod_live');
 
-const { key, ...metadata } = await res.json();
-// Guarda "key" inmediatamente; no vuelve a enviarse en respuestas posteriores.
+client.auth.useApiKey(() => readSecretFromVault());
+
+client.auth.clearApiKey();
 ```
 
-- Si omites `environment`, se usa la configuración por defecto (`production` salvo que sobrescribas `API_KEYS_ENVIRONMENT`).
-- Si omites `scopes`, el servicio aplica los scopes configurados como `API_KEYS_DEFAULT_SCOPES` (p. ej. `api-keys:read`).
-- Combina scopes mínimos necesarios para limitar el alcance siguiendo el principio de menor privilegio.
+El SDK enviará siempre el header `X-API-Key`; si lo borras, retomará la autenticación configurada en `headers`.
+
+### Alternativa low-level con `createHttp`
 
-### Revocar una API Key
+Si necesitas controlar manualmente las peticiones (por ejemplo, en un entorno con fetch custom), puedes reutilizar la misma librería interna:
 
 ```ts
-await http.doFetch(`${http.base}/v1/api-keys/${apiKeyId}`, { method: 'DELETE' });
-```
+import { createHttp } from '@getsupervisor/agents-studio-sdk';
 
-La revocación invalida la credencial de forma inmediata. Cualquier uso posterior regresará `401 Unauthorized`.
+const http = createHttp({
+  baseUrl: 'https://public-api.getsupervisor.ai',
+  headers: { Authorization: `Bearer ${token}` },
+  workspaceId: 'ws-123',
+});
+
+const { key, ...metadata } = await http
+  .doFetch(`${http.base}/v1/api-keys`, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ name: 'Automation', scopes: ['agents:read'] }),
+  })
+  .then((res) => res.json());
+```
 
 ### Buenas prácticas
 
@@ -175,7 +215,7 @@ Consulta el OpenAPI (`docs/api-spec/openapi.yaml`) para revisar nuevos scopes co
 
 ## Novedades (octubre 2025)
 
-- **Gestión de API Keys desde el SDK**: ejemplos oficiales para listar, emitir y revocar claves con `createHttp`, alineados con los endpoints `/v1/api-keys`.
+- **Gestión de API Keys desde el SDK**: `client.apiKeys` expone helpers tipados para listar, crear y revocar credenciales con el mismo manejo de cabeceras, timeouts y reintentos del resto del cliente.
 - **Scopes documentados**: tabla de scopes disponibles y recomendaciones para definir permisos mínimos por workspace.
 - **Mejoras de gobernanza**: se incorporaron pautas de rotación, almacenamiento seguro y segmentación por entorno directamente en la guía del SDK.
 

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,
@@ -34,6 +36,7 @@ __export(index_exports, {
   createAgentTagsApi: () => createAgentTagsApi,
   createAgentVersionsApi: () => createAgentVersionsApi,
   createAgentsApi: () => createAgentsApi,
+  createApiKeysApi: () => createApiKeysApi,
   createClient: () => createClient,
   createHttp: () => createHttp,
   createToolsApi: () => createToolsApi,
@@ -42,98 +45,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) {
@@ -237,8 +148,10 @@ function createHttp(cfg) {
   const retry = cfg.retry;
   const WORKSPACE_HEADER = "x-workspace-id";
   const API_KEY_HEADER = "x-api-key";
+  const AUTHORIZATION_HEADER = "authorization";
   const resolveWorkspaceId = () => cfg.getWorkspaceId?.() ?? cfg.workspaceId ?? void 0;
   const resolveApiKey = () => cfg.getApiKey?.() ?? cfg.apiKey ?? void 0;
+  const resolveAccessToken = () => cfg.getAccessToken?.() ?? cfg.accessToken ?? void 0;
   const normalizeHeaders = (headers) => {
     if (!headers) {
       return {};
@@ -264,10 +177,15 @@ function createHttp(cfg) {
     const headersWithWorkspace = workspaceId ? { [WORKSPACE_HEADER]: workspaceId } : {};
     const apiKey = resolveApiKey();
     const headersWithApiKey = apiKey ? { [API_KEY_HEADER]: apiKey } : {};
+    const accessToken = resolveAccessToken();
+    const headersWithAuthorization = accessToken ? {
+      [AUTHORIZATION_HEADER]: accessToken.startsWith("Bearer ") ? accessToken : `Bearer ${accessToken}`
+    } : {};
     return {
       ...baseHeaders,
       ...headersWithWorkspace,
       ...headersWithApiKey,
+      ...headersWithAuthorization,
       ...normalizedExtra
     };
   };
@@ -309,7 +227,8 @@ function createHttp(cfg) {
     doFetch,
     buildHeaders,
     resolveWorkspaceId,
-    resolveApiKey
+    resolveApiKey,
+    resolveAccessToken
   };
 }
 
@@ -424,6 +343,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 +776,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 +801,7 @@ var createAgentEntity = (dto, options) => {
     phonesApi,
     scheduleApi,
     versionsApi,
+    blueprintsApi,
     reload,
     updateAgent,
     deleteAgent
@@ -732,6 +813,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 +896,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);
@@ -856,6 +939,37 @@ function createAgentsApi(cfg, relatedApis) {
   };
 }
 
+// src/api/api-keys.ts
+function createApiKeysApi(cfg) {
+  const { base, doFetch } = createHttp(cfg);
+  const jsonHeaders = { "content-type": "application/json" };
+  return {
+    async list() {
+      const res = await doFetch(`${base}/v1/api-keys`, { method: "GET" });
+      return res.json();
+    },
+    async create(payload) {
+      const res = await doFetch(`${base}/v1/api-keys`, {
+        method: "POST",
+        headers: jsonHeaders,
+        body: JSON.stringify(payload)
+      });
+      return res.json();
+    },
+    async revoke(apiKeyId) {
+      await doFetch(`${base}/v1/api-keys/${apiKeyId}`, {
+        method: "DELETE"
+      });
+    },
+    async show(apiKeyId) {
+      const res = await doFetch(`${base}/v1/api-keys/${apiKeyId}/show`, {
+        method: "GET"
+      });
+      return res.json();
+    }
+  };
+}
+
 // src/api/tools.ts
 var isFormData = (value) => {
   return typeof FormData !== "undefined" && value instanceof FormData;
@@ -1048,6 +1162,7 @@ function createClient(initialCfg) {
   };
   const resolveWorkspaceId = () => runtimeCfg.workspaceId ?? runtimeCfg.getWorkspaceId?.();
   const resolveApiKey = () => runtimeCfg.apiKey ?? runtimeCfg.getApiKey?.();
+  const resolveAccessToken = () => runtimeCfg.accessToken ?? runtimeCfg.getAccessToken?.();
   const setWorkspaceId = (workspaceId) => {
     runtimeCfg.workspaceId = workspaceId;
   };
@@ -1060,18 +1175,27 @@ function createClient(initialCfg) {
   const setApiKeyGetter = (getter) => {
     runtimeCfg.getApiKey = getter;
   };
+  const setAccessToken = (token) => {
+    runtimeCfg.accessToken = token;
+  };
+  const setAccessTokenGetter = (getter) => {
+    runtimeCfg.getAccessToken = getter;
+  };
   const instructionsApi = createAgentInstructionsApi(runtimeCfg);
   const tagsApi = createAgentTagsApi(runtimeCfg);
   const phonesApi = createAgentPhonesApi(runtimeCfg);
   const scheduleApi = createAgentScheduleApi(runtimeCfg);
   const versionsApi = createAgentVersionsApi(runtimeCfg);
+  const blueprintsApi = createAgentBlueprintsApi(runtimeCfg);
   const voicesApi = createVoicesApi(runtimeCfg);
+  const apiKeysApi = createApiKeysApi(runtimeCfg);
   const agentsApi = createAgentsApi(runtimeCfg, {
     instructionsApi,
     tagsApi,
     phonesApi,
     scheduleApi,
-    versionsApi
+    versionsApi,
+    blueprintsApi
   });
   const instructionsNamespace = Object.assign(
     (agentId) => bindAgentInstructions(instructionsApi, agentId),
@@ -1093,6 +1217,10 @@ function createClient(initialCfg) {
     (agentId) => bindAgentVersions(versionsApi, agentId),
     versionsApi
   );
+  const blueprintsNamespace = Object.assign(
+    (agentId) => bindAgentBlueprints(blueprintsApi, agentId),
+    blueprintsApi
+  );
   const apis = {
     agents: {
       ...agentsApi,
@@ -1100,11 +1228,13 @@ function createClient(initialCfg) {
       tags: tagsNamespace,
       phones: phonesNamespace,
       schedule: scheduleNamespace,
-      versions: versionsNamespace
+      versions: versionsNamespace,
+      blueprints: blueprintsNamespace
     },
     workspaces: createWorkspacesApi(runtimeCfg),
     tools: createToolsApi(runtimeCfg),
-    voices: voicesApi
+    voices: voicesApi,
+    apiKeys: apiKeysApi
   };
   return {
     ...apis,
@@ -1120,6 +1250,18 @@ function createClient(initialCfg) {
       clearApiKey() {
         setApiKeyGetter(void 0);
         setApiKey(void 0);
+      },
+      getAccessToken: resolveAccessToken,
+      setAccessToken(token) {
+        setAccessTokenGetter(void 0);
+        setAccessToken(token);
+      },
+      useAccessToken(getter) {
+        setAccessTokenGetter(getter);
+      },
+      clearAccessToken() {
+        setAccessTokenGetter(void 0);
+        setAccessToken(void 0);
       }
     },
     workspace: {
@@ -1141,7 +1283,9 @@ function createClient(initialCfg) {
           workspaceId: id,
           getWorkspaceId: void 0,
           apiKey: runtimeCfg.apiKey,
-          getApiKey: runtimeCfg.getApiKey
+          getApiKey: runtimeCfg.getApiKey,
+          accessToken: runtimeCfg.accessToken,
+          getAccessToken: runtimeCfg.getAccessToken
         });
       }
     }
@@ -1152,11 +1296,13 @@ function createClient(initialCfg) {
   HttpError,
   NetworkError,
   TimeoutError,
+  bindAgentBlueprints,
   bindAgentInstructions,
   bindAgentPhones,
   bindAgentSchedule,
   bindAgentTags,
   bindAgentVersions,
+  createAgentBlueprintsApi,
   createAgentEntity,
   createAgentInstructionsApi,
   createAgentPhonesApi,
@@ -1164,6 +1310,7 @@ function createClient(initialCfg) {
   createAgentTagsApi,
   createAgentVersionsApi,
   createAgentsApi,
+  createApiKeysApi,
   createClient,
   createHttp,
   createToolsApi,