@agentforge-io/sdk-server 4.5.1 → 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

@@ -362,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.1",
+  "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",