@animalabs/agent-framework 0.6.5 → 0.6.6

package/src/mcpl/push-handler.ts

@@ -35,6 +35,7 @@ export interface McplPushEvent {
   eventId: string;
   content: ContentBlock[];
   origin?: Record<string, unknown>;
+  tags?: string[];
   timestamp: string;
   inferenceId: string;
   triggerInference?: boolean;
@@ -217,6 +218,7 @@ export class PushHandler {
       eventId: params.eventId,
       content,
       origin: params.origin,
+      tags: params.tags,
       timestamp: params.timestamp,
       inferenceId,
       triggerInference,

package/src/mcpl/server-connection.ts

@@ -31,6 +31,8 @@ import type {
   ChannelsOpenResult,
   ChannelsCloseParams,
   ChannelsCloseResult,
+  ChannelsAcknowledgeParams,
+  ChannelsAcknowledgeResult,
   ChannelsListResult,
   ChannelsPublishParams,
   ChannelsPublishResult,
@@ -397,6 +399,14 @@ export class McplServerConnection extends EventEmitter {
     return this.sendRequest(McplMethod.ChannelsClose, params as unknown as Record<string, unknown>) as Promise<ChannelsCloseResult>;
   }
 
+  /** Send `channels/acknowledge` request and await result. */
+  sendChannelsAcknowledge(params: ChannelsAcknowledgeParams): Promise<ChannelsAcknowledgeResult> {
+    return this.sendRequest(
+      McplMethod.ChannelsAcknowledge,
+      params as unknown as Record<string, unknown>,
+    ) as Promise<ChannelsAcknowledgeResult>;
+  }
+
   /** Send `channels/list` request and await result. */
   sendChannelsList(): Promise<ChannelsListResult> {
     return this.sendRequest(McplMethod.ChannelsList, {}) as Promise<ChannelsListResult>;

package/src/mcpl/types.ts

@@ -284,18 +284,9 @@ export interface McplServerConfig {
   toolPrefix?: string;
 
   /**
-   * How channels registered by this server are opened.
-   * - `'auto'` (default) — every registered channel is auto-opened; the host
-   *   receives all traffic. Matches prior behavior. Right for agents that
-   *   should listen passively (e.g. a frontdesk clerk).
-   * - `'manual'` — registered channels are listed but not opened. The agent
-   *   must call the `channel_open` tool to start receiving messages. Right
-   *   for focused agents that should not be flooded with chatter from
-   *   servers that advertise many public channels (e.g. Zulip's full stream
-   *   list).
-   * - `string[]` — allow-list of channel ids; only matching channels are
-   *   auto-opened. Ids are server-scoped (the raw id the server registers,
-   *   e.g. `"zulip:tracker-miner-f"`).
+   * @deprecated One-time migration input for an installation's old auto,
+   * manual, or allow-list policy. Runtime lifecycle state is persisted in
+   * Chronicle and changed with channel_open/channel_close.
    */
   channelSubscription?: 'auto' | 'manual' | string[];
 }
@@ -797,6 +788,33 @@ export interface ChannelDescriptor {
 
   /** Arbitrary metadata */
   metadata?: Record<string, unknown>;
+
+  /**
+   * Server bootstrap preference, consulted only when the host has no durable
+   * desired state for this channel.
+   */
+  initiallyOpen?: boolean;
+
+  /** Optional generic capabilities exposed by this channel. */
+  capabilities?: ChannelCapabilities;
+}
+
+export interface ChannelCapabilities {
+  history?: {
+    maxMessages?: number;
+    supportsBeforeMessage?: boolean;
+    supportsSinceLastSeen?: boolean;
+  };
+  acknowledgment?: {
+    kind?: string;
+    supportsValue?: boolean;
+  };
+}
+
+export interface ChannelHistoryRequest {
+  limit: number;
+  beforeMessageId?: string;
+  sinceLastSeen?: boolean;
 }
 
 /**
@@ -858,9 +876,12 @@ export interface ChannelsListResult {
  * Spec Section 14.3.
  */
 export interface ChannelsOpenParams {
+  /** Exact registered id. Preferred over type/address matching. */
+  channelId?: string;
   type: string;
   address?: Record<string, unknown>;
   metadata?: Record<string, unknown>;
+  history?: ChannelHistoryRequest;
 }
 
 /**
@@ -868,6 +889,8 @@ export interface ChannelsOpenParams {
  */
 export interface ChannelsOpenResult {
   channel: ChannelDescriptor;
+  history?: ChannelIncomingMessage[];
+  historyTruncated?: boolean;
 }
 
 /**
@@ -885,6 +908,19 @@ export interface ChannelsCloseResult {
   closed: boolean;
 }
 
+export interface ChannelsAcknowledgeParams {
+  channelId: string;
+  messageId: string;
+  intent: string;
+  value?: string;
+}
+
+export interface ChannelsAcknowledgeResult {
+  acknowledged: boolean;
+  representation?: string;
+  reason?: string;
+}
+
 /**
  * channels/outgoing/chunk params (Host → Server, Notification).
  * For observers receiving moderated deltas.
@@ -1046,6 +1082,7 @@ export const McplMethod = {
   ChannelsList: 'channels/list',
   ChannelsOpen: 'channels/open',
   ChannelsClose: 'channels/close',
+  ChannelsAcknowledge: 'channels/acknowledge',
   ChannelsOutgoingChunk: 'channels/outgoing/chunk',
   ChannelsOutgoingComplete: 'channels/outgoing/complete',
   ChannelsPublish: 'channels/publish',

package/src/types/agent.ts

@@ -107,6 +107,24 @@ export interface AgentConfig {
   };
 }
 
+/** The intentionally small set of agent settings that may change in-process. */
+export interface AgentRuntimeSettingsPatch {
+  contextBudgetTokens?: number;
+  tailTokens?: number;
+  transitionPaceTokens?: number;
+}
+
+export interface AgentRuntimeSettingsSnapshot {
+  contextBudgetTokens: number;
+  tailTokens?: number;
+  transitionPaceTokens?: number;
+  transition: 'stable' | 'converging' | 'blocked';
+  transitionReason?: 'transition_pace_too_small' | 'protected_context_exceeds_target';
+}
+
+/** Persisted values differ from recipe defaults; omitted keys inherit config. */
+export type AgentRuntimeSettingsOverrides = AgentRuntimeSettingsPatch;
+
 /**
  * Result of running inference.
  */

package/src/types/events.ts

@@ -226,6 +226,7 @@ export interface McplPushEvent {
   eventId: string;
   content: ContentBlock[];
   origin?: Record<string, unknown>;
+  tags?: string[];
   timestamp: string;
   inferenceId: string;
   triggerInference?: boolean;
@@ -249,4 +250,3 @@ export interface McplChannelIncomingEvent {
   triggerInference?: boolean;
   targetAgents?: string[];
 }
-

package/src/types/trace.ts

@@ -109,6 +109,8 @@ export type TraceEvent =
   | (TraceEventBase & {
       type: 'inference:stream_resumed';
       agentName: string;
+      /** Count of mid-turn messages injected into the resumed round (hear-while-acting). */
+      injectedMessages?: number;
     })
   | (TraceEventBase & {
       type: 'inference:stream_restarted';