@agentforge-io/sdk-server 4.0.22 → 4.1.0

package/dist/resources/chat.d.ts

@@ -9,6 +9,20 @@ export interface StreamMessageInput {
     /** Si se omite, el server crea una conversación nueva. */
     conversationId?: string;
 }
+export interface StreamMessageForAppUserInput {
+    /** Which of the App's tenant agents to run. */
+    agentId: string;
+    /** The App's own identifier for its end user — NOT signed, rides as a
+     *  plain param inside the sk_live_-authenticated request (AGF-072 §4.4
+     *  rationale: the authenticated channel is the proof, not a per-user
+     *  signature). Threads into the conversation key
+     *  `app-user:${appId}:${externalUserId}` server-side; `appId` itself is
+     *  never a param, only ever resolved from the secret. */
+    externalUserId: string;
+    content: string;
+    /** Si se omite, el server crea una conversación nueva. */
+    conversationId?: string;
+}
 export declare class ChatResource {
     private readonly client;
     constructor(client: AgentForgeClient);
@@ -52,4 +66,37 @@ export declare class ChatResource {
      * no pertenece al ChatToken que llama.
      */
     getHistory(conversationId: string): Promise<ConversationHistory>;
+    /**
+     * AGF-073a — chat streaming AGENT-AWARE para el surface App-authenticated
+     * (`sk_live_`/`sk_test_`), server-to-server — `POST
+     * /api/v1/app-user-chat/conversations/stream` (o `.../conversations/:id/
+     * messages/stream` cuando `input.conversationId` viene seteado). Sibling
+     * ADITIVO de `streamMessage()`: NO usa ChatToken, requiere que el
+     * `AgentForgeClient` se haya construido con `appSecret`. `appId` lo
+     * resuelve el server exclusivamente del secret — nunca es un param acá
+     * tampoco (ver `APP_USER_CHAT_RUNTIME_SDD.md`).
+     *
+     * Mismo shape de eventos que `streamMessage()` — `ChatStreamEvent` con
+     * los mismos `kind`s (`conversation` | `chunk` | `stream_end` | `error`).
+     * Un consumidor no puede distinguir cuál de los dos métodos produjo el
+     * stream a partir de los eventos solos.
+     *
+     * @example
+     *   const af = new AgentForgeClient({ baseURL, appSecret: 'sk_live_...' });
+     *   for await (const ev of af.chat.streamMessageForAppUser({
+     *     agentId: 'agent-uuid',
+     *     externalUserId: 'scrappydoc-user-42',
+     *     content: 'hola',
+     *   })) {
+     *     if (ev.kind === 'conversation') conversationId = ev.conversationId;
+     *   }
+     */
+    streamMessageForAppUser(input: StreamMessageForAppUserInput): AsyncGenerator<ChatStreamEvent>;
+    /**
+     * AGF-073a companion to `streamMessageForAppUser` — historial completo de
+     * una conversación app-user, `GET /api/v1/app-user-chat/conversations/:id/
+     * messages?externalUserId=...`. `externalUserId` va como query param
+     * porque GET no lleva body; `appId` sigue resolviéndose del secret.
+     */
+    getHistoryForAppUser(conversationId: string, externalUserId: string): Promise<ConversationHistory>;
 }

package/dist/resources/chat.js

@@ -110,6 +110,86 @@ class ChatResource {
     async getHistory(conversationId) {
         return this.client.request('GET', `/api/v1/chat/conversations/${encodeURIComponent(conversationId)}/messages`);
     }
+    /**
+     * AGF-073a — chat streaming AGENT-AWARE para el surface App-authenticated
+     * (`sk_live_`/`sk_test_`), server-to-server — `POST
+     * /api/v1/app-user-chat/conversations/stream` (o `.../conversations/:id/
+     * messages/stream` cuando `input.conversationId` viene seteado). Sibling
+     * ADITIVO de `streamMessage()`: NO usa ChatToken, requiere que el
+     * `AgentForgeClient` se haya construido con `appSecret`. `appId` lo
+     * resuelve el server exclusivamente del secret — nunca es un param acá
+     * tampoco (ver `APP_USER_CHAT_RUNTIME_SDD.md`).
+     *
+     * Mismo shape de eventos que `streamMessage()` — `ChatStreamEvent` con
+     * los mismos `kind`s (`conversation` | `chunk` | `stream_end` | `error`).
+     * Un consumidor no puede distinguir cuál de los dos métodos produjo el
+     * stream a partir de los eventos solos.
+     *
+     * @example
+     *   const af = new AgentForgeClient({ baseURL, appSecret: 'sk_live_...' });
+     *   for await (const ev of af.chat.streamMessageForAppUser({
+     *     agentId: 'agent-uuid',
+     *     externalUserId: 'scrappydoc-user-42',
+     *     content: 'hola',
+     *   })) {
+     *     if (ev.kind === 'conversation') conversationId = ev.conversationId;
+     *   }
+     */
+    async *streamMessageForAppUser(input) {
+        if (!this.client.getAppSecret()) {
+            throw new Error('chat.streamMessageForAppUser requires appSecret (sk_live_/sk_test_) in ' +
+                'AgentForgeClient. This surface authenticates AS the App, not via chatToken.');
+        }
+        const path = input.conversationId
+            ? `/api/v1/app-user-chat/conversations/${encodeURIComponent(input.conversationId)}/messages/stream`
+            : '/api/v1/app-user-chat/conversations/stream';
+        const res = await this.client.requestStream('POST', path, {
+            agentId: input.agentId,
+            externalUserId: input.externalUserId,
+            content: input.content,
+        });
+        if (!res.body) {
+            throw new Error('chat.streamMessageForAppUser: response has no readable body');
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            for (;;) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                let idx;
+                while ((idx = buffer.indexOf('\n\n')) !== -1) {
+                    const frame = buffer.slice(0, idx);
+                    buffer = buffer.slice(idx + 2);
+                    const raw = parseRawSseFrame(frame);
+                    if (!raw)
+                        continue;
+                    const event = toChatStreamEvent(raw);
+                    if (event)
+                        yield event;
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * AGF-073a companion to `streamMessageForAppUser` — historial completo de
+     * una conversación app-user, `GET /api/v1/app-user-chat/conversations/:id/
+     * messages?externalUserId=...`. `externalUserId` va como query param
+     * porque GET no lleva body; `appId` sigue resolviéndose del secret.
+     */
+    async getHistoryForAppUser(conversationId, externalUserId) {
+        if (!this.client.getAppSecret()) {
+            throw new Error('chat.getHistoryForAppUser requires appSecret (sk_live_/sk_test_) in AgentForgeClient.');
+        }
+        return this.client.request('GET', `/api/v1/app-user-chat/conversations/${encodeURIComponent(conversationId)}/messages` +
+            `?externalUserId=${encodeURIComponent(externalUserId)}`);
+    }
 }
 exports.ChatResource = ChatResource;
 /** Frame SSE genérico: `event: <name>\ndata: <line>\ndata: <line>...`.

package/package.json

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