@borgee/agents-host 0.2.68 → 0.2.73

package/dist/context/claude-file-brief.js

@@ -2,6 +2,7 @@ import { buildCollaborationCapabilityDeclarationSummaryLines, } from './collabor
 import { MAIN_SESSION_DELEGATION_LINES } from './main-session-delegation.js';
 import { buildResolvedWorkspaceGuidanceLines } from './resolved-workspace.js';
 import { buildSkillManualLines, buildSkillManualReadLine } from './skill-manual.js';
+import { PARENT_CHANNEL_TASK_BOUNDARY_LINES } from './task-channel-boundary.js';
 function buildStableSkillLines(context) {
     if (!context?.skillRuntime) {
         return [];
@@ -16,7 +17,7 @@ function buildStableGatewayLines(context) {
     }
     const lines = [`Gateway credential file: ${context.gatewayCredentialPath}`];
     if (context.runtimeSurface?.task.currentThread === 'parent-channel') {
-        lines.push('This channel is a parent channel, not a task thread.', 'For parent-channel task operations, use the packaged borgee-agent task rail through this gateway credential file.', 'Do not invent a bare task or bare borgee command.');
+        lines.push('This channel is a parent channel, not a task thread.', ...PARENT_CHANNEL_TASK_BOUNDARY_LINES, 'For parent-channel task operations, use the packaged borgee-agent task rail through this gateway credential file.', 'Do not invent a bare task or bare borgee command.');
         if (context.runtimeSurface.task.currentTaskShorthand === 'requires-task-id') {
             lines.push('In this parent channel, task get, task update, task history, and task property commands require an explicit task id.');
         }

package/dist/context/prompt.js

@@ -6,6 +6,7 @@ import { buildCollaborationOutcomeSummaryLines } from './collaboration-outcome.j
 import { MAIN_SESSION_DELEGATION_LINES } from './main-session-delegation.js';
 import { buildResolvedWorkspaceGuidanceLines } from './resolved-workspace.js';
 import { buildSkillManualLines, buildSkillManualReadLine } from './skill-manual.js';
+import { PARENT_CHANNEL_TASK_BOUNDARY_LINES } from './task-channel-boundary.js';
 import { buildTaskThreadCollaborationSummaryLines } from './task-thread-collaboration.js';
 function providerLabel(provider) {
     if (provider === 'copilot') {
@@ -46,6 +47,7 @@ function buildLocalhostGatewayPromptLines(context) {
         : 'This turn runs in a parent channel, not a task thread.');
     if (context.runtimeSurface?.task.currentThread === 'parent-channel'
         && (context.collaborationTurnMode ?? 'ordinary') === 'ordinary') {
+        lines.push(...PARENT_CHANNEL_TASK_BOUNDARY_LINES);
         if (context.runtimeSurface.task.parentChannelTaskCollection === 'available') {
             lines.push('Task list and task create are available in this parent channel.');
             lines.push(`For parent-channel task operations on this turn, read the packaged borgee-agent manual at ${context.skillRuntime.skillMarkdownPath} and follow that command grammar exactly.`);
@@ -132,6 +134,7 @@ function buildClaudeOrdinaryGatewayTaskLines(context) {
     const lines = [
         `Gateway credential file for this turn: ${context.gatewayCredentialPath}`,
         'This turn runs in a parent channel, not a task thread.',
+        ...PARENT_CHANNEL_TASK_BOUNDARY_LINES,
         'Task list and task create are available in this parent channel.',
         `For parent-channel task operations on this turn, read the packaged borgee-agent manual at ${context.skillRuntime.skillMarkdownPath} and follow that command grammar exactly.`,
         'For task creation and task updates in this parent channel, use the packaged borgee-agent task rail through this gateway credential file.',
@@ -169,7 +172,7 @@ function buildClaudeProjectedBriefTurnDeltaLines(context) {
             lines.push(...taskLines);
         }
         else {
-            lines.push(`Gateway credential file for this turn: ${context.gatewayCredentialPath}`, 'This turn runs in a parent channel, not a task thread.');
+            lines.push(`Gateway credential file for this turn: ${context.gatewayCredentialPath}`, 'This turn runs in a parent channel, not a task thread.', ...PARENT_CHANNEL_TASK_BOUNDARY_LINES);
             if (context.runtimeSurface.task.parentChannelTaskCollection === 'available') {
                 lines.push('Task list and task create are available in this parent channel.');
             }

package/dist/context/task-channel-boundary.d.ts

@@ -0,0 +1 @@
+export declare const PARENT_CHANNEL_TASK_BOUNDARY_LINES: readonly ["This parent channel is limited to creating and assigning tasks, coordinating them, and giving brief confirmations.", "After a task is created and assigned, do not start or continue its implementation, tool calls, or work progress in this parent channel; leave that work to the assigned task thread.", "Never work on the same task in the parent channel and its task thread at the same time."];

package/dist/context/task-channel-boundary.js

@@ -0,0 +1,5 @@
+export const PARENT_CHANNEL_TASK_BOUNDARY_LINES = [
+    'This parent channel is limited to creating and assigning tasks, coordinating them, and giving brief confirmations.',
+    'After a task is created and assigned, do not start or continue its implementation, tool calls, or work progress in this parent channel; leave that work to the assigned task thread.',
+    'Never work on the same task in the parent channel and its task thread at the same time.',
+];

package/dist/plugin-sdk.js

@@ -3814,6 +3814,47 @@ var BppTransport = class {
   getResolvedAgentId() {
     return this.currentAgentId();
   }
+  /** Fire-and-forget metadata-only lifecycle rail. Callers durably retry until ACK. */
+  sendExecutionTelemetry(frame) {
+    const base = {
+      agent_id: this.currentAgentId(),
+      execution_id: frame.executionId,
+      telemetry_context: frame.telemetryContext,
+      event_id: frame.eventId
+    };
+    switch (frame.type) {
+      case "execution_started":
+        this.send({
+          type: frame.type,
+          ...base,
+          started_at: frame.startedAt
+        });
+        break;
+      case "execution_usage":
+        this.send({
+          type: frame.type,
+          ...base,
+          usage_granularity: frame.usageGranularity,
+          ...frame.callIndex === void 0 ? {} : { call_index: frame.callIndex },
+          provider: frame.provider,
+          model: frame.model,
+          input_tokens: frame.inputTokens,
+          output_tokens: frame.outputTokens,
+          cache_read_tokens: frame.cacheReadTokens,
+          cache_write_tokens: frame.cacheWriteTokens,
+          observed_at: frame.observedAt
+        });
+        break;
+      case "execution_finished":
+        this.send({
+          type: frame.type,
+          ...base,
+          succeeded: frame.succeeded,
+          ended_at: frame.endedAt
+        });
+        break;
+    }
+  }
   async connect(ctx) {
     this.ctx = ctx;
     this.closed = false;
@@ -3991,7 +4032,12 @@ var BppTransport = class {
       plugin_id: ctx.pluginId ?? "",
       token: "",
       version: PROTOCOL_VERSION,
-      capabilities: JSON.stringify(["semantic_action", "inbound_message", "read_file"])
+      capabilities: JSON.stringify([
+        "semantic_action",
+        "inbound_message",
+        "read_file",
+        "execution_telemetry"
+      ])
     };
     this.sendTo(ws, connectFrame);
     try {
@@ -4069,6 +4115,11 @@ var BppTransport = class {
       case "inbound_message":
         this.handleInbound(env);
         break;
+      case "execution_telemetry_ack":
+        this.handlers?.onExecutionTelemetryAck?.({
+          eventId: env.event_id
+        });
+        break;
       case "semantic_action_result":
         this.handleActionResult(env);
         break;
@@ -4260,7 +4311,12 @@ var BppTransport = class {
     const specific = this.stopTurnHandler;
     const generic = this.serverRequestHandler;
     try {
-      const answer = specific ? await specific(channelId) : generic ? await generic(STOP_TURN_ACTION, data) : { aborted: false };
+      const answer = specific ? await specific(channelId) : generic ? await generic(STOP_TURN_ACTION, data) : (
+        // No handler is not the same as "unsupported": nothing was aborted,
+        // which is what false already says, and the rail carries no third
+        // value to draw that distinction with.
+        { aborted: false }
+      );
       this.send({ type: "response", id, data: this.asStopTurnResult(answer) });
     } catch (err) {
       this.logger?.warn("bpp.stop_turn_handler_failed", err);
@@ -4345,7 +4401,10 @@ var BppTransport = class {
           frame.paths = action.activity.paths;
         break;
       case "plan":
-        frame.plan = action.activity.entries.map((entry) => ({ label: entry.label, status: entry.status }));
+        frame.plan = action.activity.entries.map((entry) => ({
+          label: entry.label,
+          status: entry.status
+        }));
         break;
       case "output":
         frame.stream = action.activity.stream;
@@ -4467,7 +4526,11 @@ function encodeActionPayload(action) {
     case "delete_message":
       return { message_id: action.messageId };
     case "react":
-      return { message_id: action.messageId, emoji: action.emoji, removed: action.removed ?? false };
+      return {
+        message_id: action.messageId,
+        emoji: action.emoji,
+        removed: action.removed ?? false
+      };
     case "create_dm":
       return { user_id: action.userId };
     case "get_me":
@@ -4484,6 +4547,7 @@ function encodeActionPayload(action) {
       return {};
     case "create_channel":
       return {
+        guild_id: action.guildId,
         name: action.name,
         topic: action.topic,
         visibility: action.visibility,
@@ -4652,9 +4716,23 @@ function mapInbound(frame) {
     kind,
     channelId: frame.channel_id,
     channelType: frame.channel_type,
+    ...frame.conversation_context ? {
+      conversationContext: {
+        guildId: frame.conversation_context.guild_id,
+        topLevelChannelId: frame.conversation_context.top_level_channel_id,
+        ...frame.conversation_context.thread_id ? { threadId: frame.conversation_context.thread_id } : {},
+        ...frame.conversation_context.task_id ? { taskId: frame.conversation_context.task_id } : {}
+      }
+    } : {},
     authorName: frame.author_name,
     createdAt: frame.created_at
   };
+  if (frame.execution_id && frame.telemetry_context) {
+    base.executionGrant = {
+      executionId: frame.execution_id,
+      telemetryContext: frame.telemetry_context
+    };
+  }
   switch (kind) {
     case "message":
     case "mention": {
@@ -4842,7 +4920,8 @@ var Client = class {
     message: /* @__PURE__ */ new Set(),
     configUpdate: /* @__PURE__ */ new Set(),
     permissionDenied: /* @__PURE__ */ new Set(),
-    connectionState: /* @__PURE__ */ new Set()
+    connectionState: /* @__PURE__ */ new Set(),
+    executionTelemetryAck: /* @__PURE__ */ new Set()
   };
   constructor(opts, transport) {
     this.opts = opts;
@@ -4914,6 +4993,7 @@ var Client = class {
   async createChannel(input) {
     return await this.t.perform({
       op: "create_channel",
+      guildId: input.guildId,
       name: input.name,
       topic: input.topic,
       visibility: input.visibility,
@@ -4955,6 +5035,9 @@ var Client = class {
       activity: input.activity
     }).catch((err) => this.logger.warn("reportActivity failed", err));
   }
+  reportExecutionTelemetry(frame) {
+    this.t.sendExecutionTelemetry?.(frame);
+  }
   reportTurnActivity(input) {
     return new TurnActivityReporter({
       ...input,
@@ -5076,7 +5159,8 @@ var Client = class {
       onStateChange: (s) => {
         this._state = s;
         this.emit("connectionState", s);
-      }
+      },
+      onExecutionTelemetryAck: (ack) => this.emit("executionTelemetryAck", ack)
     };
   }
   context() {