@robota-sdk/agent-transport 3.0.0-beta.96 → 3.0.0-beta.97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-transport",
-  "version": "3.0.0-beta.96",
+  "version": "3.0.0-beta.97",
   "description": "Carrier-neutral wire protocol, session dispatch and delivery for Robota SDK transports",
   "type": "module",
   "main": "dist/node/index.js",
@@ -80,13 +80,13 @@
   ],
   "dependencies": {
     "jose": "6.2.3",
-    "@robota-sdk/agent-core": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-analytics": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-command": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-execution": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-session": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-session-mobility": "3.0.0-beta.96",
-    "@robota-sdk/agent-interface-transport": "3.0.0-beta.96"
+    "@robota-sdk/agent-core": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-analytics": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-command": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-execution": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-session": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-session-mobility": "3.0.0-beta.97",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.97"
   },
   "devDependencies": {
     "rimraf": "^5.0.10",

package/src/__tests__/message-decoders.test.ts

@@ -838,3 +838,33 @@ describe('decodeFrame — the one carrier path', () => {
     });
   });
 });
+
+describe('completed compaction metadata', () => {
+  it('accepts both a legacy history change and the optional typed completion', () => {
+    for (const message of [
+      { type: 'history_changed' },
+      {
+        type: 'history_changed',
+        compact: { trigger: 'auto', beforeUsedPercentage: 90.5, afterUsedPercentage: 20 },
+      },
+      {
+        type: 'history_changed',
+        compact: { trigger: 'manual', beforeUsedPercentage: 10, afterUsedPercentage: 2 },
+      },
+    ]) {
+      expect(decodeServerMessage(message)).toEqual({ ok: true, message });
+    }
+  });
+
+  it.each([
+    null,
+    [],
+    {},
+    { trigger: 'unknown', beforeUsedPercentage: 90, afterUsedPercentage: 20 },
+    { trigger: 'auto', beforeUsedPercentage: '90', afterUsedPercentage: 20 },
+    { trigger: 'auto', beforeUsedPercentage: 90, afterUsedPercentage: NaN },
+    { trigger: 'auto', beforeUsedPercentage: Infinity, afterUsedPercentage: 20 },
+  ])('refuses malformed completion metadata %j', (compact) => {
+    expect(decodeServerMessage({ type: 'history_changed', compact }).ok).toBe(false);
+  });
+});

package/src/__tests__/session-history-wire.test.ts

@@ -303,7 +303,7 @@ describe('pushed session state (#3189)', () => {
     expect(client.sent).toEqual([{ type: 'context', state }]);
   });
 
-  it.each(['compact', 'skill_activation', 'memory_event'])(
+  it.each(['skill_activation', 'memory_event'])(
     'tells the client the history changed on %s, without sending the entries',
     (event) => {
       const session = createSession();
@@ -315,6 +315,25 @@ describe('pushed session state (#3189)', () => {
     },
   );
 
+  it('preserves completed compaction metadata without sending or replacing history entries', () => {
+    const session = createSession();
+    const client = attach(session);
+    session.emit('compact', {
+      trigger: 'auto',
+      before: { usedTokens: 900, maxTokens: 1000, usedPercentage: 90, remainingPercentage: 10 },
+      after: { usedTokens: 200, maxTokens: 1000, usedPercentage: 20, remainingPercentage: 80 },
+    });
+    expect(client.sent).toEqual([
+      {
+        type: 'history_changed',
+        compact: { trigger: 'auto', beforeUsedPercentage: 90, afterUsedPercentage: 20 },
+      },
+    ]);
+    client.leave();
+    session.emit('compact', { trigger: 'auto' });
+    expect(client.sent).toHaveLength(1);
+  });
+
   it('delivers where a turn came from', () => {
     const session = createSession();
     const client = attach(session);
@@ -330,12 +349,15 @@ describe('pushed session state (#3189)', () => {
     const state = { usedTokens: 1, maxTokens: 10, usedPercentage: 10, remainingPercentage: 90 };
 
     session.emit('context_update', state);
-    session.emit('compact', {});
+    session.emit('compact', { trigger: 'auto', before: state, after: state });
     session.emit('turn_source', 'user');
 
     expect(observer.sent).toEqual([
       { type: 'context', state },
-      { type: 'history_changed' },
+      {
+        type: 'history_changed',
+        compact: { trigger: 'auto', beforeUsedPercentage: 10, afterUsedPercentage: 10 },
+      },
       { type: 'turn_source', source: 'user' },
     ]);
   });

package/src/message-decoders.ts

@@ -324,7 +324,15 @@ export const SERVER_MESSAGE_SHAPES: Readonly<Record<TServerMessage['type'], TVar
   messages: { messages: isRecordArray, display: isOptional(isRecordArray), ...authored },
   history: { startIndex: isCount, total: isCount, entries: isWireHistoryEntries },
   context: { state: isRecord },
-  history_changed: {},
+  history_changed: {
+    compact: isOptional(
+      (value) =>
+        isRecord(value) &&
+        oneOf(['auto', 'manual'])(value['trigger']) &&
+        isFiniteNumber(value['beforeUsedPercentage']) &&
+        isFiniteNumber(value['afterUsedPercentage']),
+    ),
+  },
   turn_source: { source: oneOf(Object.keys(TURN_SOURCES)) },
   commands: { commands: isRecordArray, skills: isRecordArray },
   session_status: { status: isRecord },

package/src/session-events.ts

@@ -25,6 +25,7 @@ import type {
 import type {
   IAskRequestEvent,
   IBranchEvent,
+  ICompactEvent,
   IContextFileRefreshedEvent,
   IExecutionResult,
   IPermissionRequestEvent,
@@ -203,6 +204,15 @@ export function subscribeSessionEvents(
   const onContextUpdate = (state: ReturnType<IProtocolSession['getContextState']>): void =>
     deliver({ type: 'context', state });
   const onHistoryChanged = (): void => deliver({ type: 'history_changed' });
+  const onCompact = (event: ICompactEvent): void =>
+    deliver({
+      type: 'history_changed',
+      compact: {
+        trigger: event.trigger,
+        beforeUsedPercentage: event.before.usedPercentage,
+        afterUsedPercentage: event.after.usedPercentage,
+      },
+    });
   const onTurnSource = (source: TTurnSource): void => deliver({ type: 'turn_source', source });
   // One client's `/mode` or `/model` shows on every client on this session, in the frame
   // `get-status` answers with.
@@ -233,7 +243,7 @@ export function subscribeSessionEvents(
   session.on('history_cleared', onHistoryCleared);
   session.on('session_switched', onSessionSwitched);
   session.on('context_update', onContextUpdate);
-  session.on('compact', onHistoryChanged);
+  session.on('compact', onCompact);
   session.on('skill_activation', onHistoryChanged);
   session.on('memory_event', onHistoryChanged);
   session.on('turn_source', onTurnSource);
@@ -264,7 +274,7 @@ export function subscribeSessionEvents(
     session.off('history_cleared', onHistoryCleared);
     session.off('session_switched', onSessionSwitched);
     session.off('context_update', onContextUpdate);
-    session.off('compact', onHistoryChanged);
+    session.off('compact', onCompact);
     session.off('skill_activation', onHistoryChanged);
     session.off('memory_event', onHistoryChanged);
     session.off('turn_source', onTurnSource);

package/src/wire-messages.ts

@@ -32,6 +32,7 @@ import type {
 import type {
   IAskRequestEvent,
   IBranchEvent,
+  ICompactEvent,
   IExecutionResult,
   IContextFileRefreshedEvent,
   IModelListGroup,
@@ -270,7 +271,15 @@ export type TServerMessage =
   | { type: 'context'; state: ReturnType<ISessionConversationRead['getContextState']> }
   // #3189: the full history gained entries that no streamed frame carries (a compaction, a skill
   // activation, a memory event). A client that shows the full history re-reads it with `get-history`.
-  | { type: 'history_changed' }
+  | {
+      type: 'history_changed';
+      /** A completed compaction, for clients that do not render the full system history. */
+      compact?: {
+        trigger: ICompactEvent['trigger'];
+        beforeUsedPercentage: number;
+        afterUsedPercentage: number;
+      };
+    }
   // #3189: where the turn now starting came from (the user, a wake-up, a peer, an external event).
   | { type: 'turn_source'; source: TTurnSource }
   | { type: 'commands'; commands: ICommandListEntry[]; skills: ICommandSkillListEntry[] }

package/dist/browser/observer-messages-DoWb6RNv.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"observer-messages-DoWb6RNv.d.ts","names":[],"sources":["../../src/wire-messages.ts","../../src/message-decoders.ts","../../src/observer-messages.ts"],"mappings":"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"}