@borgee/agents-host 0.2.65 → 0.2.73

package/dist/compatibility-gates.d.ts

@@ -25,12 +25,14 @@ export type InternalPolicyMode = 'audit-only' | 'enforce';
 export type InternalProviderImplementationPath = 'v1' | 'v2';
 export type InternalProviderImplementationKey = 'claude' | 'copilot';
 export type InternalProviderImplementationOverrides = Partial<Record<InternalProviderImplementationKey, InternalProviderImplementationPath>>;
+export declare const CURRENT_AGENTS_HOST_PACKAGE_VERSION: string;
 export interface ManagedRuntimeSettingsSnapshot {
     schemaVersion: number;
     compatibilityGates: string[];
     providerImplementationOverrides: string[];
     internalPolicyMode: InternalPolicyMode;
     projectionStrategy: ProjectionStrategy;
+    packageVersion: string;
 }
 export declare const DEFAULT_INTERNAL_COMPATIBILITY_GATES: readonly string[];
 export declare function resolveInternalProjectionStrategy(env?: NodeJS.ProcessEnv): ProjectionStrategy;

package/dist/compatibility-gates.js

@@ -1,4 +1,7 @@
 import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { DEFAULT_PROJECTION_STRATEGY, normalizeProjectionStrategy, } from './projection-strategy-values.js';
 export const CLAUDE_PROVIDER_V2_COMPATIBILITY_GATE = 'claude-provider-v2';
 export const COPILOT_PROVIDER_V2_COMPATIBILITY_GATE = 'copilot-provider-v2';
@@ -22,6 +25,15 @@ export const INTERNAL_POLICY_MODE_ENV = 'AGENTS_HOST_INTERNAL_POLICY_MODE';
 export const INTERNAL_PROVIDER_IMPLEMENTATIONS_ENV = 'AGENTS_HOST_INTERNAL_PROVIDER_IMPLEMENTATIONS';
 export const INTERNAL_CLAUDE_PROMPT_STRATEGY_ENV = 'AGENTS_HOST_INTERNAL_CLAUDE_PROMPT_STRATEGY';
 export const MANAGED_RUNTIME_SETTINGS_SCHEMA_VERSION = 1;
+function readCurrentAgentsHostPackageVersion() {
+    const packageManifestPath = join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    const manifest = JSON.parse(readFileSync(packageManifestPath, 'utf8'));
+    if (typeof manifest.version !== 'string' || manifest.version.length === 0) {
+        throw new Error(`Unable to resolve agents-host package version from ${packageManifestPath}`);
+    }
+    return manifest.version;
+}
+export const CURRENT_AGENTS_HOST_PACKAGE_VERSION = readCurrentAgentsHostPackageVersion();
 const VALID_PROVIDER_IMPLEMENTATION_ENTRIES = '"claude:v1", "claude:v2", "copilot:v1", or "copilot:v2"';
 export const DEFAULT_INTERNAL_COMPATIBILITY_GATES = Object.freeze([
     ATTENTION_FOLLOW_SEMANTICS_COMPATIBILITY_GATE,
@@ -176,6 +188,7 @@ export function resolveManagedRuntimeSettingsSnapshot(env = process.env) {
         providerImplementationOverrides: resolveManagedRuntimeProviderImplementationOverrides(env, compatibilityGates),
         internalPolicyMode: resolveInternalPolicyMode(compatibilityGates.includes(POLICY_AUDIT_ENFORCEMENT_COMPATIBILITY_GATE), env),
         projectionStrategy: resolveInternalProjectionStrategy(env),
+        packageVersion: CURRENT_AGENTS_HOST_PACKAGE_VERSION,
     };
 }
 export function serializeManagedRuntimeSettingsSnapshot(snapshot) {

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.');
             }
@@ -565,9 +568,7 @@ function buildClaudeZeroTurnPrompt(params) {
     }
     const gatewayTaskLines = buildClaudeOrdinaryGatewayTaskLines(params.promptContext);
     return [
-        'Do not claim to have performed actions you did not actually perform.',
         ...(gatewayTaskLines.length > 0 ? [...gatewayTaskLines, ''] : []),
-        `New message from ${params.incomingAuthorId}:`,
         params.incomingContent,
     ].join('\n');
 }

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/managed-daemon.js

@@ -7,7 +7,7 @@ import { fileURLToPath } from 'node:url';
 import { AgentsHostSupervisor } from './agents-host-supervisor.js';
 import { DEFAULT_PROJECTION_STRATEGY, normalizeProjectionStrategy, } from './projection-strategy-values.js';
 import { resolveChannelWorkspaceDirectory, resolveChannelWorkspaceRootDirectory, resolveManagedWorkspaceCollectionRoot, resolveTaskThreadScratchWorkspaceDirectory, } from './context/injection.js';
-import { CLAUDE_PROVIDER_V2_COMPATIBILITY_GATE, COMPATIBILITY_GATES_ENV, createManagedRuntimeSettingsFingerprint, INTERNAL_CLAUDE_PROMPT_STRATEGY_ENV, INTERNAL_DISABLED_COMPATIBILITY_GATES_ENV, INTERNAL_POLICY_MODE_ENV, INTERNAL_PROVIDER_IMPLEMENTATIONS_ENV, MANAGED_RUNTIME_CONVERGENCE_COMPATIBILITY_GATE, MANAGED_RUNTIME_SETTINGS_SCHEMA_VERSION, resolveDisabledDefaultCompatibilityGates, resolveManagedRuntimeSettingsSnapshot, serializeManagedRuntimeSettingsSnapshot, normalizeInternalProviderImplementationOverrides, } from './compatibility-gates.js';
+import { CLAUDE_PROVIDER_V2_COMPATIBILITY_GATE, COMPATIBILITY_GATES_ENV, CURRENT_AGENTS_HOST_PACKAGE_VERSION, createManagedRuntimeSettingsFingerprint, INTERNAL_CLAUDE_PROMPT_STRATEGY_ENV, INTERNAL_DISABLED_COMPATIBILITY_GATES_ENV, INTERNAL_POLICY_MODE_ENV, INTERNAL_PROVIDER_IMPLEMENTATIONS_ENV, MANAGED_RUNTIME_CONVERGENCE_COMPATIBILITY_GATE, MANAGED_RUNTIME_SETTINGS_SCHEMA_VERSION, resolveDisabledDefaultCompatibilityGates, resolveManagedRuntimeSettingsSnapshot, serializeManagedRuntimeSettingsSnapshot, normalizeInternalProviderImplementationOverrides, } from './compatibility-gates.js';
 import { DEFAULT_PROVIDER_COMMAND_CONFIG, hasLegacyClaudeOneShotArgs, loadConfigFromEnv, } from './config.js';
 import { loadLocalConfigGenerateSpec, materializeLocalConfig, parseGenerateConfigSpec, resolveLocalConfigLayout, } from './local-config.js';
 import { normalizeManagedRuntimeKey, resolveManagedBootstrapLockPath, resolveManagedDaemonEndpoint, resolveManagedDaemonLogPath, resolveManagedRuntimeRoot, resolveManagedStateRoot, resolveManagedRuntimeSettingsPath, } from './state-paths.js';
@@ -163,6 +163,7 @@ function normalizeManagedRuntimeSettingsSnapshot(snapshot) {
         providerImplementationOverrides,
         internalPolicyMode: snapshot.internalPolicyMode,
         projectionStrategy: snapshot.projectionStrategy ?? DEFAULT_PROJECTION_STRATEGY,
+        packageVersion: CURRENT_AGENTS_HOST_PACKAGE_VERSION,
     };
 }
 function parseManagedRuntimeSettingsSnapshotRecord(value, sourceLabel) {
@@ -197,6 +198,9 @@ function parseManagedRuntimeSettingsSnapshotRecord(value, sourceLabel) {
         providerImplementationOverrides: [...record.providerImplementationOverrides],
         internalPolicyMode: record.internalPolicyMode,
         projectionStrategy: projectionStrategy ?? DEFAULT_PROJECTION_STRATEGY,
+        packageVersion: typeof record.packageVersion === 'string' && record.packageVersion.trim().length > 0
+            ? record.packageVersion
+            : CURRENT_AGENTS_HOST_PACKAGE_VERSION,
     });
 }
 async function loadManagedRuntimeSettingsSnapshot(rootPath) {

package/dist/plugin-sdk.js

@@ -3777,7 +3777,6 @@ var BppTransport = class {
   // send issued during a reconnect never races ahead of the handshake.
   online = false;
   terminal = false;
-  inboundFailed = false;
   inboundChain = Promise.resolve();
   configChain = Promise.resolve();
   configAcks = /* @__PURE__ */ new Map();
@@ -3815,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;
@@ -3941,8 +3981,15 @@ var BppTransport = class {
         }
       });
       ws.on("close", (code, reason) => {
+        const closeReason = reason?.toString("utf8") ?? "";
         connectionAbort.abort();
         const wasCurrent = this.ws === ws;
+        const closeSummary = `code=${code} reason=${closeReason || "<none>"} current=${wasCurrent}`;
+        if (code === 1e3 || this.closed) {
+          this.logger?.info("bpp.ws_closed", closeSummary);
+        } else {
+          this.logger?.warn("bpp.ws_closed", closeSummary);
+        }
         if (wasCurrent) {
           this.online = false;
           this.stopHeartbeat();
@@ -3952,7 +3999,7 @@ var BppTransport = class {
         if (authFailed && wasCurrent) {
           this.closed = true;
           this.terminal = true;
-          this.logger?.error("bpp.auth_failed", `server closed with ${WS_CLOSE_AUTH_FAILED} (authentication failed); not reconnecting. reason=${reason?.toString("utf8") ?? ""}`);
+          this.logger?.error("bpp.auth_failed", `server closed with ${WS_CLOSE_AUTH_FAILED} (authentication failed); not reconnecting. reason=${closeReason}`);
           this.handlers?.onStateChange({ status: "error", reason: "api_key_invalid" });
         }
         if (wasCurrent) {
@@ -3985,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 {
@@ -3998,6 +4050,7 @@ var BppTransport = class {
       }
       this.startHeartbeat();
       this.goOnline(ws);
+      this.logger?.info("bpp.connected");
       resolve();
     } catch (error) {
       const failure = error instanceof BorgeeError ? error : new BorgeeError(`agent identity handshake failed: ${String(error)}`, "bpp.identity_unresolved");
@@ -4011,6 +4064,7 @@ var BppTransport = class {
     this.reconnectAttempt += 1;
     const delay = Math.min(this.reconnectBaseMs * 2 ** (this.reconnectAttempt - 1), this.reconnectMaxMs);
     this.handlers?.onStateChange({ status: "reconnecting", attempt: this.reconnectAttempt });
+    this.logger?.info("bpp.reconnect_scheduled", `attempt=${this.reconnectAttempt} delay_ms=${delay}`);
     this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = void 0;
       if (this.closed)
@@ -4061,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;
@@ -4080,12 +4139,11 @@ var BppTransport = class {
   }
   handleInbound(frame) {
     this.inboundChain = this.inboundChain.then(() => {
-      if (this.inboundFailed)
-        return;
-      this.handlers?.onInbound(mapInbound(frame));
-    }).catch((error) => {
-      this.inboundFailed = true;
-      this.failTerminal(this.inboundFailure(error), this.ws);
+      try {
+        this.handlers?.onInbound(mapInbound(frame));
+      } catch (error) {
+        this.logger?.error("bpp.inbound_dispatch_failed", this.inboundFailure(error));
+      }
     });
   }
   handleActionResult(frame) {
@@ -4253,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);
@@ -4338,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;
@@ -4380,6 +4446,7 @@ var BppTransport = class {
   failTerminal(error, ws) {
     if (this.terminal)
       return;
+    this.logger?.error("bpp.terminal_failure", error);
     this.terminal = true;
     this.online = false;
     this.handlers?.onStateChange({ status: "error", reason: "unknown", code: error.code });
@@ -4459,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":
@@ -4476,6 +4547,7 @@ function encodeActionPayload(action) {
       return {};
     case "create_channel":
       return {
+        guild_id: action.guildId,
         name: action.name,
         topic: action.topic,
         visibility: action.visibility,
@@ -4644,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": {
@@ -4834,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;
@@ -4906,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,
@@ -4947,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,
@@ -5051,8 +5142,13 @@ var Client = class {
     this.t.setStopTurnHandler?.(handler);
   }
   emit(event, payload) {
-    for (const h of this.listeners[event])
-      h(payload);
+    for (const h of this.listeners[event]) {
+      try {
+        h(payload);
+      } catch (error) {
+        this.logger.error("client.observer_failed", { event, error });
+      }
+    }
   }
   handlers() {
     return {
@@ -5063,7 +5159,8 @@ var Client = class {
       onStateChange: (s) => {
         this._state = s;
         this.emit("connectionState", s);
-      }
+      },
+      onExecutionTelemetryAck: (ack) => this.emit("executionTelemetryAck", ack)
     };
   }
   context() {