@agentforge-io/sdk-server 4.5.0 → 4.5.2

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { AgentForgeClient } from './client';
 export type { AgentForgeClientOptions, RequestOptions } from './client';
 export { AgentForgeError, AgentForgeAuthError, AgentForgeNotFoundError, AgentForgeNetworkError, } from './errors';
 export { TOOL_CALLBACK_HEADERS, ToolCallbackSignatureError, signToolCallbackPayload, verifyToolCallbackSignature, } from './webhooks';
-export type { AgentMe, AgentSummary, AppUserConnectorStatus, ApprovalCopyBundle, ChatStreamChunk, ChatStreamEvent, ChatTokenRecord, ConnectorDefaultsResult, ConnectorDefaultsSource, ConnectorResourceItem, ConnectorStatus, ConnectorToolInfo, ConversationHistory, ConversationStatus, CreateAgentInput, CreateClickupTaskInput, CreateClickupTaskResult, ExternalToolSummary, IssueChatTokenInput, ListAgentsResult, ListConnectorResourcesResult, McpServerConfig, MessageRecord, MessageRole, PublicAppBranding, AppSelf, AppSelfConnector, AppSelfConnectors, RegisterToolInput, RegisterToolsInput, RegisterToolsResult, ToolCallbackPayload, ToolCallRecord, ToolPermission, ToolPermissionMode, TokenUsage, TenantSecretEntry, UpdateAgentInput, } from './types';
+export type { AgentMe, AgentSummary, AppUserConnectorStatus, ApprovalCopyBundle, ChannelContext, ChatStreamChunk, ChatStreamEvent, ChatTokenRecord, ConnectorDefaultsResult, ConnectorDefaultsSource, ConnectorResourceItem, ConnectorStatus, ConnectorToolInfo, ConversationHistory, ConversationStatus, CreateAgentInput, CreateClickupTaskInput, CreateClickupTaskResult, ExternalToolSummary, IssueChatTokenInput, ListAgentsResult, ListConnectorResourcesResult, McpServerConfig, MessageRecord, MessageRole, PublicAppBranding, AppSelf, AppSelfConnector, AppSelfConnectors, RegisterToolInput, RegisterToolsInput, RegisterToolsResult, ToolCallbackPayload, ToolCallRecord, ToolPermission, ToolPermissionMode, TokenUsage, TenantSecretEntry, UpdateAgentInput, } from './types';
 export { AgentsResource } from './resources/agents';
 export { AppsResource } from './resources/apps';
 export { ChatResource } from './resources/chat';

package/dist/resources/chat.d.ts

@@ -1,5 +1,5 @@
 import type { AgentForgeClient } from '../client';
-import type { ChatStreamEvent, ConversationHistory } from '../types';
+import type { ChannelContext, ChatStreamEvent, ConversationHistory } from '../types';
 export interface AnthropicClientOptions {
     /** Override de la versión Anthropic. Default: '2023-06-01'. */
     anthropicVersion?: string;
@@ -8,6 +8,15 @@ export interface StreamMessageInput {
     content: string;
     /** Si se omite, el server crea una conversación nueva. */
     conversationId?: string;
+    /**
+     * AGF-CHANNEL-CTX PR-2 — which surface this turn is coming through (and
+     * who's on the other end). Threads through to the platform's
+     * `AgentOverrides.channel` (core), which `resolvePresentationPolicy`
+     * consumes to decide whether `OutputSanitizerService` runs this turn.
+     * Omit for legacy callers — the resolved policy defaults to `'strict'`
+     * (today's behavior), zero regression.
+     */
+    channel?: ChannelContext;
 }
 export interface StreamMessageForAppUserInput {
     /** Which of the App's tenant agents to run. */
@@ -22,6 +31,17 @@ export interface StreamMessageForAppUserInput {
     content: string;
     /** Si se omite, el server crea una conversación nueva. */
     conversationId?: string;
+    /**
+     * AGF-CHANNEL-CTX PR-2 — which surface this turn is coming through (and
+     * who's on the other end). Threads through to the platform's
+     * `AgentOverrides.channel` (core), which `resolvePresentationPolicy`
+     * consumes to decide whether `OutputSanitizerService` runs this turn.
+     * Omit for legacy callers — the resolved policy defaults to `'strict'`
+     * (today's behavior), zero regression. ScrappyDoc's SOP Architect
+     * Composer (PR-3) declares `{ id: 'app-operator', audience: 'operator' }`
+     * here to turn the sanitizer OFF for this operator-facing surface.
+     */
+    channel?: ChannelContext;
 }
 export declare class ChatResource {
     private readonly client;

package/dist/resources/chat.js

@@ -70,6 +70,7 @@ class ChatResource {
         const res = await this.client.requestStream('POST', '/api/v1/chat/messages/stream', {
             content: input.content,
             ...(input.conversationId ? { conversationId: input.conversationId } : {}),
+            ...(input.channel ? { channel: input.channel } : {}),
         });
         if (!res.body) {
             throw new Error('chat.streamMessage: response has no readable body');
@@ -147,6 +148,7 @@ class ChatResource {
             agentId: input.agentId,
             externalUserId: input.externalUserId,
             content: input.content,
+            ...(input.channel ? { channel: input.channel } : {}),
         });
         if (!res.body) {
             throw new Error('chat.streamMessageForAppUser: response has no readable body');

package/dist/types.d.ts

@@ -139,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;
@@ -156,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;
@@ -176,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[];
@@ -322,6 +362,17 @@ export type ChatStreamEvent = {
     kind: 'error';
     message: string;
 };
+export interface ChannelContext {
+    /** Stable channel id. Open enum — hosts pass their own; core only
+     *  special-cases the ones it ships a default for via `audience`/`sanitize`. */
+    id: 'whatsapp' | 'voice' | 'app-operator' | 'public' | 'b2b-console' | (string & {});
+    /** Who is on the other end. Drives the DEFAULT presentation policy when
+     *  `sanitize` isn't set explicitly. */
+    audience?: 'customer' | 'operator' | 'internal';
+    /** Optional explicit override of the derived policy (escape hatch). Wins
+     *  over `audience` when present. */
+    sanitize?: 'strict' | 'voice' | 'off';
+}
 export interface ConnectorStatus {
     connectorId: string;
     /** ¿El tenant ya completó el OAuth/API-key setup de este connector? */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.5.0",
+  "version": "4.5.2",
   "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",