@agentforge-io/sdk-server 4.4.0 → 4.5.1

package/dist/types.d.ts

@@ -95,6 +95,17 @@ export interface RegisterToolInput {
     executionMode?: 'client' | 'remote';
     /** Requerido cuando `executionMode === 'remote'`. */
     callbackUrl?: string;
+    /** Opcional. Si se provee, el platform usa ESTE valor como secret HMAC
+     *  en vez de generar uno random — compartido por todas las tools que
+     *  apunten al mismo `callbackUrl` (ver secretForGroup() en
+     *  ExternalToolsRepository, agentforge-platform). Útil para derivar un
+     *  secret determinístico desde una credencial persistente propia (p.ej.
+     *  un `sk_live_`/app secret que sobrevive redeploys), en vez de depender
+     *  de un secret generado por el platform que solo se muestra una vez y
+     *  que se pierde si el cache local del cliente vive en disco efímero.
+     *  Mínimo 16 caracteres. Omitilo para preservar el comportamiento
+     *  anterior (secret generado por el platform). */
+    plaintextSecret?: string;
 }
 export interface RegisterToolsInput {
     tools: RegisterToolInput[];
@@ -128,6 +139,26 @@ export interface AgentSummary {
     createdAt: string | Date;
     updatedAt: string | Date;
 }
+/**
+ * Visibilidad del perfil público del agent (`/a/:publicSlug`).
+ * Default en el backend: `'private'`.
+ */
+export type AgentProfileVisibility = 'private' | 'public';
+/** Template visual del perfil público del agent. */
+export type AgentProfileTemplate = 'minimal' | 'brand' | 'beacons';
+/**
+ * Bloque de contenido del perfil público (link, bio, imagen, etc.).
+ * Shape exacto por `type` — la validación profunda vive en el backend
+ * (`agent-config.service.ts` / `normalizeProfileBlocks`), el SDK solo
+ * pasa el objeto tal cual.
+ */
+export type ProfileBlock = Record<string, unknown>;
+/**
+ * Tema visual del perfil público (colores, fuente, etc.).
+ * La validación profunda vive en el backend (`normalizeProfileTheme`);
+ * el SDK solo pasa el objeto tal cual.
+ */
+export type ProfileTheme = Record<string, unknown>;
 export interface CreateAgentInput {
     slug: string;
     name: string;
@@ -145,6 +176,16 @@ export interface CreateAgentInput {
         name: string;
         mode: ToolPermissionMode;
     }>;
+    /**
+     * Handle del creador para el perfil público (`/a/:publicSlug`). Formato
+     * `/^[a-z0-9][a-z0-9_-]{0,46}[a-z0-9]$/` (2-48, lowercase), único global.
+     * Si se omite, el backend auto-mintea uno (`generatePublicSlug()`).
+     */
+    publicSlug?: string;
+    visibility?: AgentProfileVisibility;
+    profileTemplate?: AgentProfileTemplate;
+    profileBlocks?: ProfileBlock[];
+    profileTheme?: ProfileTheme;
 }
 export interface UpdateAgentInput {
     name?: string;
@@ -165,6 +206,16 @@ export interface UpdateAgentInput {
         name: string;
         mode: ToolPermissionMode;
     }>;
+    /**
+     * Handle del creador para el perfil público (`/a/:publicSlug`). Mismo
+     * formato que en `CreateAgentInput`; el backend valida formato +
+     * unicidad global y responde 409 si choca.
+     */
+    publicSlug?: string;
+    visibility?: AgentProfileVisibility;
+    profileTemplate?: AgentProfileTemplate;
+    profileBlocks?: ProfileBlock[];
+    profileTheme?: ProfileTheme;
 }
 export interface ListAgentsResult {
     items: AgentSummary[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.4.0",
+  "version": "4.5.1",
   "description": "Server-side SDK for backend apps integrating with AgentForge platform. Auth via ChatToken or ak_live_ API key.",
   "license": "MIT",
   "main": "dist/index.js",