agl 22.0.4 → 24.0.0

package/ts_interfaces/interfaces.ts

@@ -1,10 +1,9 @@
-import * as plugins from './plugins.js';
-
-export const controllerProtocolVersion = 22 as const;
+export const controllerProtocolVersion = 24 as const;
 export const controllerUpgradeManagementVersion = 2 as const;
 export const controllerPackageName = 'agl' as const;
 export const controllerMaxToolEventBytes = 48 * 1024;
 export const controllerMaxLiveMessageEventBytes = 128 * 1024;
+export const controllerLiveMessageDeltaTargetBytes = 16 * 1024;
 export const controllerInitialMessageBundleLimit = 20;
 export const controllerMaximumMessageBundles = 200;
 export const controllerMaximumTranscriptBytes = 512 * 1024;
@@ -222,6 +221,8 @@ export interface IControllerBrowserTabState {
 }
 
 export interface IControllerBrowserViewState {
+  /** Monotonic for the complete lifetime of one browser view. */
+  revision: number;
   status: 'stopped' | 'starting' | 'running' | 'stopping';
   activeTabId: string | null;
   viewportRevision: number;
@@ -230,9 +231,7 @@ export interface IControllerBrowserViewState {
   lastError?: { code: string; message: string; fatal: boolean; tabId?: string };
 }
 
-export interface IControllerBrowserFrame<
-  TDirection extends plugins.typedrequestInterfaces.TVirtualStreamDirection,
-> {
+export interface IControllerBrowserFrameMetadata {
   tabId: string;
   sequence: number;
   generation: number;
@@ -251,14 +250,16 @@ export interface IControllerBrowserFrame<
     scrollOffsetY: number;
     timestamp?: number;
   };
-  dataStream: plugins.typedrequestInterfaces.TVirtualStream<TDirection>;
+  dataByteLength: number;
 }
 
-export type TControllerBrowserViewEvent<
-  TDirection extends plugins.typedrequestInterfaces.TVirtualStreamDirection,
-> =
+export interface IControllerBrowserFrame extends Omit<IControllerBrowserFrameMetadata, 'dataByteLength'> {
+  data: Uint8Array;
+}
+
+export type TControllerBrowserViewEvent =
   | { type: 'state'; state: IControllerBrowserViewState }
-  | { type: 'frame'; frame: IControllerBrowserFrame<TDirection> }
+  | { type: 'frame'; frame: IControllerBrowserFrame }
   | { type: 'error'; error: { code: string; message: string; fatal: boolean; tabId?: string } };
 
 export interface IControllerBrowserFrameAcknowledgement {
@@ -475,6 +476,34 @@ export interface IControllerTextUpdate {
   streamEpoch: number;
 }
 
+export interface IControllerReasoningDelta {
+  sessionId: IControllerRuntimeId;
+  messageId: IControllerRuntimeId;
+  partId: IControllerRuntimeId;
+  delta: string;
+  baseTextUtf8Bytes: number;
+  textUtf8Bytes: number;
+  /** Authoritative source coordinates; required for Flex and absent for OpenCode. */
+  order?: IControllerTranscriptOrder;
+  sourceUpdatedAt: number;
+  revision: number;
+  streamEpoch: number;
+}
+
+export interface IControllerTextDelta {
+  sessionId: IControllerRuntimeId;
+  messageId: IControllerRuntimeId;
+  partId: IControllerRuntimeId;
+  delta: string;
+  baseTextUtf8Bytes: number;
+  textUtf8Bytes: number;
+  /** Authoritative source coordinates; required for Flex and absent for OpenCode. */
+  order?: IControllerTranscriptOrder;
+  sourceUpdatedAt: number;
+  revision: number;
+  streamEpoch: number;
+}
+
 export interface IControllerToolStreamCursor {
   streamEpoch: number;
   revision: number;
@@ -788,7 +817,9 @@ export const controllerEventTypes = [
   'session.history.changed',
   'session.tool.updated',
   'session.reasoning.updated',
+  'session.reasoning.delta',
   'session.text.updated',
+  'session.text.delta',
   'permissions.changed',
   'harness.changed',
   'projects.changed',
@@ -813,8 +844,12 @@ export interface IControllerEvent {
   toolExecution?: IControllerToolExecution;
   /** Present only on a live OpenCode or Flex reasoning snapshot. */
   reasoningUpdate?: IControllerReasoningUpdate;
+  /** Present only on an exact live OpenCode or Flex reasoning delta. */
+  reasoningDelta?: IControllerReasoningDelta;
   /** Present only on a live OpenCode or Flex text snapshot. */
   textUpdate?: IControllerTextUpdate;
+  /** Present only on an exact live OpenCode or Flex text delta. */
+  textDelta?: IControllerTextDelta;
   /** Present only on a session.draft.changed event. */
   sessionDraftUpdate?: IControllerSessionDraftUpdate;
   /** Ordered harness stream barrier carried by harness.changed. */

package/ts_interfaces/requests.ts

@@ -10,8 +10,6 @@ import type {
   TControllerResource,
   TControllerResourceKind,
   IControllerBrowserViewState,
-  TControllerBrowserViewEvent,
-  TControllerBrowserViewOperation,
   IControllerProvider,
   IControllerProviderAccountRateLimits,
   IControllerProviderConnection,
@@ -927,6 +925,9 @@ export interface IReq_ControllerBrowserViewOpen extends plugins.typedrequestInte
     viewId: string;
     resourceId: string;
     attachmentRevision: number;
+    streamGeneration: number;
+    events: plugins.typedrequestInterfaces.TVirtualStream<'receive'>;
+    operations: plugins.typedrequestInterfaces.TVirtualStream<'send'>;
     state: IControllerBrowserViewState;
   };
 }
@@ -936,41 +937,34 @@ export interface IReq_ControllerBrowserViewActivate extends plugins.typedrequest
   IReq_ControllerBrowserViewActivate
 > {
   method: 'controller.browser.view.activate';
-  request: { viewId: string };
+  request: { viewId: string; streamGeneration: number };
   response: { activated: true };
 }
 
-export interface IReq_ControllerBrowserViewClose extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_ControllerBrowserViewClose
-> {
-  method: 'controller.browser.view.close';
-  request: { viewId: string };
-  response: { closed: true };
-}
-
-export interface IReq_ControllerBrowserViewOperate extends plugins.typedrequestInterfaces.implementsTR<
-  plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_ControllerBrowserViewOperate
-> {
-  method: 'controller.browser.view.operate';
-  request: { viewId: string; operation: TControllerBrowserViewOperation };
-  response: { accepted: boolean; state: IControllerBrowserViewState };
-}
-
-/** Server to client push for one exact human browser view. */
-export interface IReq_ControllerBrowserViewEvent extends plugins.typedrequestInterfaces.implementsTR<
+export interface IReq_ControllerBrowserViewRecover extends plugins.typedrequestInterfaces.implementsTR<
   plugins.typedrequestInterfaces.ITypedRequest,
-  IReq_ControllerBrowserViewEvent
+  IReq_ControllerBrowserViewRecover
 > {
-  method: 'controller.browser.view.event';
-  request: {
+  method: 'controller.browser.view.recover';
+  request: { viewId: string; expectedStreamGeneration: number };
+  response: {
     viewId: string;
     resourceId: string;
     attachmentRevision: number;
-    event: TControllerBrowserViewEvent<'send'>;
+    streamGeneration: number;
+    events: plugins.typedrequestInterfaces.TVirtualStream<'receive'>;
+    operations: plugins.typedrequestInterfaces.TVirtualStream<'send'>;
+    state: IControllerBrowserViewState;
   };
-  response: Record<string, never>;
+}
+
+export interface IReq_ControllerBrowserViewClose extends plugins.typedrequestInterfaces.implementsTR<
+  plugins.typedrequestInterfaces.ITypedRequest,
+  IReq_ControllerBrowserViewClose
+> {
+  method: 'controller.browser.view.close';
+  request: { viewId: string; expectedStreamGeneration: number };
+  response: { closed: boolean };
 }
 
 export interface IReq_ControllerTerminalCreate extends plugins.typedrequestInterfaces.implementsTR<
@@ -1171,8 +1165,8 @@ export type TControllerRequest =
   | IReq_ControllerResourceStop
   | IReq_ControllerBrowserViewOpen
   | IReq_ControllerBrowserViewActivate
+  | IReq_ControllerBrowserViewRecover
   | IReq_ControllerBrowserViewClose
-  | IReq_ControllerBrowserViewOperate
   | IReq_ControllerTerminalList
   | IReq_ControllerTerminalCreate
   | IReq_ControllerTerminalRename
@@ -1182,5 +1176,4 @@ export type TControllerRequest =
   | IReq_ControllerTerminalInput
   | IReq_ControllerTerminalResize
   | IReq_ControllerTerminalOutput
-  | IReq_ControllerBrowserViewEvent
   | IReq_ControllerEvent;

package/ts_web/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: 'agl',
-  version: '22.0.4',
+  version: '24.0.0',
   description: 'Agent Gateway Layer for OpenCode and FlexHarness sessions'
 }