@agentforge-io/sdk-server 4.11.0 → 4.12.0

package/dist/resources/chat.d.ts

@@ -48,6 +48,16 @@ export interface StreamMessageForAppUserInput {
      * as "declared by the App, not verified by AgentForge"; omit for no claims.
      */
     caller?: AppCallerClaims;
+    /**
+     * AGF-100g — set when the App shows human-owned conversations to its own
+     * people (e.g. through `af.inbox.forAgent(agentId)`). Then, when the agent
+     * calls `request_human_review`, the conversation's thread moves to human
+     * mode: the agent stops answering until a person hands it back (or the
+     * team's handback timeout does), and the stream ends with a
+     * `{ type: 'mode', mode: 'human', reason: 'escalated' }` chunk. Omit it if
+     * nobody on the App side will answer — the tool then stays a no-op.
+     */
+    humanHandoff?: boolean;
 }
 /** What an App declares about its end user on a chat turn (see `caller`). */
 export interface AppCallerClaims {

package/dist/resources/chat.js

@@ -150,6 +150,7 @@ class ChatResource {
             content: input.content,
             ...(input.channel ? { channel: input.channel } : {}),
             ...(input.caller ? { caller: input.caller } : {}),
+            ...(input.humanHandoff ? { humanHandoff: true } : {}),
         });
         if (!res.body) {
             throw new Error('chat.streamMessageForAppUser: response has no readable body');

package/dist/types.d.ts

@@ -342,6 +342,18 @@ export type ChatStreamChunk = ({
     connectorName?: string;
     toolDescription?: string;
     copy?: ApprovalCopyBundle;
+} | {
+    /**
+     * AGF-100g — App-user chat only: who owns the conversation's inbox
+     * thread. Sent once after `conversation` (`mode: 'agent'`), as the
+     * only frame when a human owns the thread (`mode: 'human'`, the
+     * agent did not run), and before the stream closes when this turn
+     * escalated to a human (`reason: 'escalated'`, needs `humanHandoff`).
+     */
+    type: 'mode';
+    mode: InboxThreadMode;
+    threadId: string;
+    reason?: 'escalated';
 } | {
     type: 'done';
     messageId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge-io/sdk-server",
-  "version": "4.11.0",
+  "version": "4.12.0",
   "description": "Server-side SDK for backend apps integrating with AgentForge platform. Auth via ChatToken, ak_live_ API key or App secret (sk_live_), with App installations across tenants.",
   "license": "MIT",
   "main": "dist/index.js",