@borgee/agents-host 0.2.94 → 0.2.97

package/dist/agents-host.js

@@ -368,6 +368,14 @@ export class AgentsHost {
             cancel: this.provider.cancelBackgroundRun
                 ? (channelId, providerRunId) => (this.provider.cancelBackgroundRun(channelId, providerRunId))
                 : undefined,
+            onFinished: (channelId, run) => {
+                this.borgee.reportTaskFinished?.({
+                    channelId,
+                    taskId: run.runId,
+                    outcome: run.state,
+                    ...(run.state === 'failed' ? { reason: 'unknown' } : {}),
+                });
+            },
         });
     }
     async start() {

package/dist/background-runs.d.ts

@@ -4,6 +4,10 @@ interface BackgroundRunTrackerOptions {
     lifecycleSupported: boolean;
     targetedCancellationSupported: boolean;
     cancel?: (channelId: string, providerRunId: string) => Promise<boolean>;
+    onFinished?: (channelId: string, run: {
+        runId: string;
+        state: 'completed' | 'failed' | 'cancelled';
+    }) => void;
 }
 export declare class BackgroundRunTracker {
     private readonly report;

package/dist/background-runs.js

@@ -99,6 +99,10 @@ export class BackgroundRunTracker {
             historySize -= 1;
         }
         this.publish(run);
+        if (isConcreteTerminal(state) &&
+            (startsNewExecution || !held || !isConcreteTerminal(held.state))) {
+            this.options.onFinished?.(channelId, { runId: run.runId, state });
+        }
     }
     replay() {
         for (const run of this.runs.values()) {
@@ -166,10 +170,10 @@ function runState(status) {
     }
 }
 function isTerminal(state) {
-    return (state === 'completed' ||
-        state === 'failed' ||
-        state === 'cancelled' ||
-        state === 'unknown');
+    return (isConcreteTerminal(state) || state === 'unknown');
+}
+function isConcreteTerminal(state) {
+    return state === 'completed' || state === 'failed' || state === 'cancelled';
 }
 function stableRunId(channelId, providerRunId, startedAt, executionId) {
     const digest = createHash('sha256')

package/dist/chat/chat-control-plane.d.ts

@@ -1,4 +1,4 @@
-import type { AgentActivity, ReportTurnActivityInput, StopBackgroundRunHandler, StopTurnHandler, TurnActivityReporter } from '../plugin-sdk.js';
+import type { AgentActivity, ReportTaskFinishedInput, ReportTurnActivityInput, StopBackgroundRunHandler, StopTurnHandler, TurnActivityReporter } from '../plugin-sdk.js';
 import type { ChannelSummary, ChannelHistoryEntry, ChannelMessageEvent, CreateTaskInput, DirectoryUser, MeResponseUser, PostMessageInput, PostedMessage, ReadChannelHistoryInput, Task, UpdateTaskInput } from '../types.js';
 export interface ChatControlPlane {
     onStopTurn?(handler: StopTurnHandler | undefined): void;
@@ -12,6 +12,7 @@ export interface ChatControlPlane {
     startTyping(channelId: string): () => void;
     /** Opens one turn's report on the activity rail. Fire-and-forget: nothing recovers what it sends. */
     reportTurnActivity(input: ReportTurnActivityInput): TurnActivityReporter;
+    reportTaskFinished?(input: ReportTaskFinishedInput): void;
     reportActivity?(input: {
         channelId: string;
         activity: AgentActivity;

package/dist/chat/sdk-chat-control-plane.d.ts

@@ -1,7 +1,7 @@
-import { type BorgeePluginClient, type BorgeePluginOptions, type InboundMessageEvent, type ReportTurnActivityInput, type StopTurnHandler, type StopBackgroundRunHandler, type TurnActivityReporter } from '../plugin-sdk.js';
+import { type BorgeePluginClient, type BorgeePluginOptions, type InboundMessageEvent, type ReportTaskFinishedInput, type ReportTurnActivityInput, type StopTurnHandler, type StopBackgroundRunHandler, type TurnActivityReporter } from '../plugin-sdk.js';
 import type { ChannelSummary, ChannelHistoryEntry, ChannelMessageEvent, CreateTaskInput, DirectoryUser, MeResponseUser, PostMessageInput, PostedMessage, ReadChannelHistoryInput, Task, UpdateTaskInput } from '../types.js';
 import type { ChatControlPlane } from './chat-control-plane.js';
-type PluginClientLike = Pick<BorgeePluginClient, 'agentId' | 'close' | 'connect' | 'createTask' | 'deleteMessage' | 'editMessage' | 'getMe' | 'getTask' | 'listChannels' | 'listTasks' | 'listUsers' | 'on' | 'onStopTurn' | 'onStopBackgroundRun' | 'reportActivity' | 'readHistory' | 'reportTurnActivity' | 'sendMessage' | 'startTyping' | 'updateTask' | 'setTaskProperty' | 'deleteTaskProperty'>;
+type PluginClientLike = Pick<BorgeePluginClient, 'agentId' | 'close' | 'connect' | 'createTask' | 'deleteMessage' | 'editMessage' | 'getMe' | 'getTask' | 'listChannels' | 'listTasks' | 'listUsers' | 'on' | 'onStopTurn' | 'onStopBackgroundRun' | 'reportActivity' | 'readHistory' | 'reportTurnActivity' | 'sendMessage' | 'startTyping' | 'updateTask' | 'setTaskProperty' | 'deleteTaskProperty'> & Partial<Pick<BorgeePluginClient, 'reportTaskFinished'>>;
 type PluginClientFactory = (options: BorgeePluginOptions) => PluginClientLike;
 type SdkChatControlPlaneOptions = Pick<BorgeePluginOptions, 'pluginId'>;
 /**
@@ -25,6 +25,7 @@ export declare class SdkChatControlPlane implements ChatControlPlane {
     close(): Promise<void>;
     postMessage(input: PostMessageInput): Promise<PostedMessage>;
     reportActivity(input: Parameters<BorgeePluginClient['reportActivity']>[0]): void;
+    reportTaskFinished(input: ReportTaskFinishedInput): void;
     editMessage(messageId: string, content: string): Promise<void>;
     deleteMessage(messageId: string): Promise<void>;
     startTyping(channelId: string): () => void;

package/dist/chat/sdk-chat-control-plane.js

@@ -82,6 +82,9 @@ export class SdkChatControlPlane {
     reportActivity(input) {
         this.client.reportActivity(input);
     }
+    reportTaskFinished(input) {
+        this.client.reportTaskFinished?.(input);
+    }
     async editMessage(messageId, content) {
         await this.client.editMessage({ messageId, body: content });
     }

package/dist/plugin-sdk.js

@@ -4502,7 +4502,7 @@ var BppTransport = class {
     };
     this.send(frame);
   }
-  // sendActivity flattens the four-shape union onto one frame. The union is
+  // sendActivity flattens the activity union onto one frame. The union is
   // how a producer says which shape it is reporting; the wire puts the
   // discriminator beside its payload with no wrapper object, matching both the
   // protocol this relays and inbound_message's own `kind`.
@@ -4575,6 +4575,18 @@ var BppTransport = class {
         frame.stop_supported = action.activity.stopSupported;
         frame.stop_unsupported_reason = action.activity.stopUnsupportedReason ?? "";
         break;
+      case "normalized":
+        frame.protocol_version = action.activity.protocolVersion;
+        frame.task_id = action.activity.taskId;
+        frame.event = action.activity.event;
+        break;
+    }
+    if (action.activity.shape === "normalized") {
+      const ids = [frame.channel_id, frame.task_id];
+      if (ids.some((value) => new TextEncoder().encode(value).byteLength > 256))
+        return;
+      if (new TextEncoder().encode(JSON.stringify(frame)).byteLength > 32768)
+        return;
     }
     this.send(frame);
   }