agl 22.0.4 → 24.0.0

package/dist_ts_interfaces/browsertransport.js

@@ -0,0 +1,47 @@
+export const controllerBrowserTransportProtocol = 'agl-browser-v24';
+export const controllerBrowserTransportEventContentType = 'application/vnd.agl.browser-events.v24';
+export const controllerBrowserTransportOperationContentType = 'application/vnd.agl.browser-operations.v24';
+export const controllerBrowserTransportMaximumJsonBytes = 64 * 1024;
+export const controllerBrowserTransportMaximumFrameBytes = 4 * 1024 * 1024;
+export const controllerBrowserTransportPairOpenTimeoutMs = 9_000;
+export const controllerBrowserTransportRecoveryGraceMs = 15_000;
+export const controllerBrowserTransportMaximumRecoveryAttempts = 3;
+export const controllerBrowserTransportMaximumPendingOperations = 64;
+export const controllerBrowserTransportMaximumQueuedOperationBytes = 256 * 1024;
+export const controllerBrowserTransportMaximumActiveAcknowledgements = 16;
+export const controllerBrowserTransportMaximumPendingEvents = 16;
+export const controllerBrowserTransportMaximumPendingEventBytes = 16 * 1024 * 1024;
+export class ControllerBrowserTransportProtocolError extends Error {
+    constructor(messageArg, optionsArg) {
+        super(messageArg, optionsArg);
+        this.name = 'ControllerBrowserTransportProtocolError';
+    }
+}
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder('utf-8', { fatal: true });
+export const encodeControllerBrowserTransportPacket = (packetArg) => {
+    let serialized;
+    try {
+        serialized = JSON.stringify(packetArg);
+    }
+    catch (errorArg) {
+        throw new ControllerBrowserTransportProtocolError('The browser transport packet is not JSON serializable.', { cause: errorArg });
+    }
+    const bytes = textEncoder.encode(serialized);
+    if (bytes.byteLength > controllerBrowserTransportMaximumJsonBytes) {
+        throw new ControllerBrowserTransportProtocolError('The browser transport packet exceeds the JSON byte limit.');
+    }
+    return bytes;
+};
+export const decodeControllerBrowserTransportPacket = (bytesArg) => {
+    if (bytesArg.byteLength > controllerBrowserTransportMaximumJsonBytes) {
+        throw new ControllerBrowserTransportProtocolError('The browser transport packet exceeds the JSON byte limit.');
+    }
+    try {
+        return JSON.parse(textDecoder.decode(bytesArg));
+    }
+    catch (errorArg) {
+        throw new ControllerBrowserTransportProtocolError('The browser transport packet is not valid UTF-8 JSON.', { cause: errorArg });
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJvd3NlcnRyYW5zcG9ydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvYnJvd3NlcnRyYW5zcG9ydC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFNQSxNQUFNLENBQUMsTUFBTSxrQ0FBa0MsR0FBRyxpQkFBMEIsQ0FBQztBQUM3RSxNQUFNLENBQUMsTUFBTSwwQ0FBMEMsR0FDckQsd0NBQWlELENBQUM7QUFDcEQsTUFBTSxDQUFDLE1BQU0sOENBQThDLEdBQ3pELDRDQUFxRCxDQUFDO0FBQ3hELE1BQU0sQ0FBQyxNQUFNLDBDQUEwQyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDcEUsTUFBTSxDQUFDLE1BQU0sMkNBQTJDLEdBQUcsQ0FBQyxHQUFHLElBQUksR0FBRyxJQUFJLENBQUM7QUFDM0UsTUFBTSxDQUFDLE1BQU0sMkNBQTJDLEdBQUcsS0FBSyxDQUFDO0FBQ2pFLE1BQU0sQ0FBQyxNQUFNLHlDQUF5QyxHQUFHLE1BQU0sQ0FBQztBQUNoRSxNQUFNLENBQUMsTUFBTSxpREFBaUQsR0FBRyxDQUFDLENBQUM7QUFDbkUsTUFBTSxDQUFDLE1BQU0sa0RBQWtELEdBQUcsRUFBRSxDQUFDO0FBQ3JFLE1BQU0sQ0FBQyxNQUFNLHFEQUFxRCxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDaEYsTUFBTSxDQUFDLE1BQU0sdURBQXVELEdBQUcsRUFBRSxDQUFDO0FBQzFFLE1BQU0sQ0FBQyxNQUFNLDhDQUE4QyxHQUFHLEVBQUUsQ0FBQztBQUNqRSxNQUFNLENBQUMsTUFBTSxrREFBa0QsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQTREbkYsTUFBTSxPQUFPLHVDQUF3QyxTQUFRLEtBQUs7SUFDaEUsWUFBWSxVQUFrQixFQUFFLFVBQXlCO1FBQ3ZELEtBQUssQ0FBQyxVQUFVLEVBQUUsVUFBVSxDQUFDLENBQUM7UUFDOUIsSUFBSSxDQUFDLElBQUksR0FBRyx5Q0FBeUMsQ0FBQztJQUN4RCxDQUFDO0NBQ0Y7QUFFRCxNQUFNLFdBQVcsR0FBRyxJQUFJLFdBQVcsRUFBRSxDQUFDO0FBQ3RDLE1BQU0sV0FBVyxHQUFHLElBQUksV0FBVyxDQUFDLE9BQU8sRUFBRSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0FBRTlELE1BQU0sQ0FBQyxNQUFNLHNDQUFzQyxHQUFHLENBQ3BELFNBQTBFLEVBQzlELEVBQUU7SUFDZCxJQUFJLFVBQWtCLENBQUM7SUFDdkIsSUFBSSxDQUFDO1FBQ0gsVUFBVSxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDekMsQ0FBQztJQUFDLE9BQU8sUUFBUSxFQUFFLENBQUM7UUFDbEIsTUFBTSxJQUFJLHVDQUF1QyxDQUMvQyx3REFBd0QsRUFDeEQsRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFLENBQ3BCLENBQUM7SUFDSixDQUFDO0lBQ0QsTUFBTSxLQUFLLEdBQUcsV0FBVyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUM3QyxJQUFJLEtBQUssQ0FBQyxVQUFVLEdBQUcsMENBQTBDLEVBQUUsQ0FBQztRQUNsRSxNQUFNLElBQUksdUNBQXVDLENBQy9DLDJEQUEyRCxDQUM1RCxDQUFDO0lBQ0osQ0FBQztJQUNELE9BQU8sS0FBSyxDQUFDO0FBQ2YsQ0FBQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sc0NBQXNDLEdBQUcsQ0FBQyxRQUFvQixFQUFXLEVBQUU7SUFDdEYsSUFBSSxRQUFRLENBQUMsVUFBVSxHQUFHLDBDQUEwQyxFQUFFLENBQUM7UUFDckUsTUFBTSxJQUFJLHVDQUF1QyxDQUMvQywyREFBMkQsQ0FDNUQsQ0FBQztJQUNKLENBQUM7SUFDRCxJQUFJLENBQUM7UUFDSCxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDO0lBQ2xELENBQUM7SUFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO1FBQ2xCLE1BQU0sSUFBSSx1Q0FBdUMsQ0FDL0MsdURBQXVELEVBQ3ZELEVBQUUsS0FBSyxFQUFFLFFBQVEsRUFBRSxDQUNwQixDQUFDO0lBQ0osQ0FBQztBQUNILENBQUMsQ0FBQyJ9

package/dist_ts_interfaces/index.d.ts

@@ -1,2 +1,3 @@
 export * from './interfaces.js';
+export * from './browsertransport.js';
 export * from './requests.js';

package/dist_ts_interfaces/index.js

@@ -1,3 +1,4 @@
 export * from './interfaces.js';
+export * from './browsertransport.js';
 export * from './requests.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyxlQUFlLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLGVBQWUsQ0FBQyJ9

package/dist_ts_interfaces/interfaces.d.ts

@@ -1,9 +1,9 @@
-import * as plugins from './plugins.js';
-export declare const controllerProtocolVersion: 22;
+export declare const controllerProtocolVersion: 24;
 export declare const controllerUpgradeManagementVersion: 2;
 export declare const controllerPackageName: "agl";
 export declare const controllerMaxToolEventBytes: number;
 export declare const controllerMaxLiveMessageEventBytes: number;
+export declare const controllerLiveMessageDeltaTargetBytes: number;
 export declare const controllerInitialMessageBundleLimit = 20;
 export declare const controllerMaximumMessageBundles = 200;
 export declare const controllerMaximumTranscriptBytes: number;
@@ -189,6 +189,8 @@ export interface IControllerBrowserTabState {
     streaming: boolean;
 }
 export interface IControllerBrowserViewState {
+    /** Monotonic for the complete lifetime of one browser view. */
+    revision: number;
     status: 'stopped' | 'starting' | 'running' | 'stopping';
     activeTabId: string | null;
     viewportRevision: number;
@@ -201,7 +203,7 @@ export interface IControllerBrowserViewState {
         tabId?: string;
     };
 }
-export interface IControllerBrowserFrame<TDirection extends plugins.typedrequestInterfaces.TVirtualStreamDirection> {
+export interface IControllerBrowserFrameMetadata {
     tabId: string;
     sequence: number;
     generation: number;
@@ -220,14 +222,17 @@ export interface IControllerBrowserFrame<TDirection extends plugins.typedrequest
         scrollOffsetY: number;
         timestamp?: number;
     };
-    dataStream: plugins.typedrequestInterfaces.TVirtualStream<TDirection>;
+    dataByteLength: number;
+}
+export interface IControllerBrowserFrame extends Omit<IControllerBrowserFrameMetadata, 'dataByteLength'> {
+    data: Uint8Array;
 }
-export type TControllerBrowserViewEvent<TDirection extends plugins.typedrequestInterfaces.TVirtualStreamDirection> = {
+export type TControllerBrowserViewEvent = {
     type: 'state';
     state: IControllerBrowserViewState;
 } | {
     type: 'frame';
-    frame: IControllerBrowserFrame<TDirection>;
+    frame: IControllerBrowserFrame;
 } | {
     type: 'error';
     error: {
@@ -453,6 +458,32 @@ export interface IControllerTextUpdate {
     revision: number;
     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;
@@ -718,7 +749,7 @@ export interface IControllerModelRefreshJob {
  * client validates incoming events against this list at runtime, so a type
  * added here is automatically deliverable — the two cannot drift apart.
  */
-export declare const controllerEventTypes: readonly ["sessions.changed", "session.changed", "session.draft.changed", "session.history.changed", "session.tool.updated", "session.reasoning.updated", "session.text.updated", "permissions.changed", "harness.changed", "projects.changed", "settings.changed", "sessiongroups.changed", "resources.changed", "terminals.changed", "upgrade.changed"];
+export declare const controllerEventTypes: readonly ["sessions.changed", "session.changed", "session.draft.changed", "session.history.changed", "session.tool.updated", "session.reasoning.updated", "session.reasoning.delta", "session.text.updated", "session.text.delta", "permissions.changed", "harness.changed", "projects.changed", "settings.changed", "sessiongroups.changed", "resources.changed", "terminals.changed", "upgrade.changed"];
 export type TControllerEventType = (typeof controllerEventTypes)[number];
 export interface IControllerEvent {
     type: TControllerEventType;
@@ -733,8 +764,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/dist_ts_interfaces/interfaces.js

@@ -1,9 +1,9 @@
-import * as plugins from './plugins.js';
-export const controllerProtocolVersion = 22;
+export const controllerProtocolVersion = 24;
 export const controllerUpgradeManagementVersion = 2;
 export const controllerPackageName = 'agl';
 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;
@@ -34,7 +34,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',
@@ -44,4 +46,4 @@ export const controllerEventTypes = [
     'terminals.changed',
     'upgrade.changed',
 ];
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxFQUFXLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsQ0FBVSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEtBQWMsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0sbUNBQW1DLEdBQUcsRUFBRSxDQUFDO0FBQ3RELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLEdBQUcsQ0FBQztBQUNuRCxNQUFNLENBQUMsTUFBTSxnQ0FBZ0MsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQzNELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUMxQyw4REFBdUUsQ0FBQztBQUMxRSxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLENBQUMsQ0FBQztBQUMvQyxNQUFNLENBQUMsTUFBTSxpQ0FBaUMsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUNsRSxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUN2RSxNQUFNLENBQUMsTUFBTSx3Q0FBd0MsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBRWxFLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxZQUFZLENBQVUsQ0FBQztBQUNoRixNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxDQUFDLFVBQVUsRUFBRSxNQUFNLENBQVUsQ0FBQztBQW1CekUsNkVBQTZFO0FBQzdFLE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLENBQUMsWUFBa0MsRUFBVSxFQUFFLENBQ25GLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxZQUFZLENBQUMsU0FBUyxFQUFFLFlBQVksQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDO0FBVWxFOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFVLENBQUM7QUFvdEJ0Rjs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUc7SUFDbEMsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQix1QkFBdUI7SUFDdkIseUJBQXlCO0lBQ3pCLHNCQUFzQjtJQUN0QiwyQkFBMkI7SUFDM0Isc0JBQXNCO0lBQ3RCLHFCQUFxQjtJQUNyQixpQkFBaUI7SUFDakIsa0JBQWtCO0lBQ2xCLGtCQUFrQjtJQUNsQix1QkFBdUI7SUFDdkIsbUJBQW1CO0lBQ25CLG1CQUFtQjtJQUNuQixpQkFBaUI7Q0FDVCxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxFQUFXLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsQ0FBVSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEtBQWMsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0scUNBQXFDLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUMvRCxNQUFNLENBQUMsTUFBTSxtQ0FBbUMsR0FBRyxFQUFFLENBQUM7QUFDdEQsTUFBTSxDQUFDLE1BQU0sK0JBQStCLEdBQUcsR0FBRyxDQUFDO0FBQ25ELE1BQU0sQ0FBQyxNQUFNLGdDQUFnQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDM0QsTUFBTSxDQUFDLE1BQU0sK0JBQStCLEdBQzFDLDhEQUF1RSxDQUFDO0FBQzFFLE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsQ0FBQyxDQUFDO0FBQy9DLE1BQU0sQ0FBQyxNQUFNLGlDQUFpQyxHQUFHLEVBQUUsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDO0FBQ2xFLE1BQU0sQ0FBQyxNQUFNLHNDQUFzQyxHQUFHLEVBQUUsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDO0FBQ3ZFLE1BQU0sQ0FBQyxNQUFNLHdDQUF3QyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFFbEUsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLFlBQVksQ0FBVSxDQUFDO0FBQ2hGLE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLENBQUMsVUFBVSxFQUFFLE1BQU0sQ0FBVSxDQUFDO0FBbUJ6RSw2RUFBNkU7QUFDN0UsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsQ0FBQyxZQUFrQyxFQUFVLEVBQUUsQ0FDbkYsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLFlBQVksQ0FBQyxTQUFTLEVBQUUsWUFBWSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7QUFVbEU7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQVUsQ0FBQztBQWt2QnRGOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRztJQUNsQyxrQkFBa0I7SUFDbEIsaUJBQWlCO0lBQ2pCLHVCQUF1QjtJQUN2Qix5QkFBeUI7SUFDekIsc0JBQXNCO0lBQ3RCLDJCQUEyQjtJQUMzQix5QkFBeUI7SUFDekIsc0JBQXNCO0lBQ3RCLG9CQUFvQjtJQUNwQixxQkFBcUI7SUFDckIsaUJBQWlCO0lBQ2pCLGtCQUFrQjtJQUNsQixrQkFBa0I7SUFDbEIsdUJBQXVCO0lBQ3ZCLG1CQUFtQjtJQUNuQixtQkFBbUI7SUFDbkIsaUJBQWlCO0NBQ1QsQ0FBQyJ9

package/dist_ts_interfaces/requests.d.ts

@@ -1,5 +1,5 @@
 import * as plugins from './plugins.js';
-import type { IControllerEvent, IControllerMessageBundle, IControllerMessagePage, TControllerModelChoice, TControllerModelOption, IControllerPathSuggestion, IControllerProject, TControllerResource, TControllerResourceKind, IControllerBrowserViewState, TControllerBrowserViewEvent, TControllerBrowserViewOperation, IControllerProvider, IControllerProviderAccountRateLimits, IControllerProviderConnection, IControllerProviderLogin, IControllerModelRefreshJob, IControllerRuntimeId, IControllerSession, IControllerSessionDraft, IControllerDraftAttachment, IControllerSessionGroup, IControllerSessionLayout, IControllerTerminal, TControllerTerminalId, IControllerSlashListResult, TControllerSlashExecuteResult, IControllerSessionDetail, IControllerSessionAuxiliary, IControllerSessionScratchpad, IControllerIntelligenceExchange, IControllerSettings, IControllerStatus, IControllerSystemMetrics, TControllerAuthState, TControllerPermissionReply, TControllerSessionHarnessId, TControllerSessionId } from './interfaces.js';
+import type { IControllerEvent, IControllerMessageBundle, IControllerMessagePage, TControllerModelChoice, TControllerModelOption, IControllerPathSuggestion, IControllerProject, TControllerResource, TControllerResourceKind, IControllerBrowserViewState, IControllerProvider, IControllerProviderAccountRateLimits, IControllerProviderConnection, IControllerProviderLogin, IControllerModelRefreshJob, IControllerRuntimeId, IControllerSession, IControllerSessionDraft, IControllerDraftAttachment, IControllerSessionGroup, IControllerSessionLayout, IControllerTerminal, TControllerTerminalId, IControllerSlashListResult, TControllerSlashExecuteResult, IControllerSessionDetail, IControllerSessionAuxiliary, IControllerSessionScratchpad, IControllerIntelligenceExchange, IControllerSettings, IControllerStatus, IControllerSystemMetrics, TControllerAuthState, TControllerPermissionReply, TControllerSessionHarnessId, TControllerSessionId } from './interfaces.js';
 export interface IReq_ControllerStatus extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ControllerStatus> {
     method: 'controller.status';
     request: Record<string, never>;
@@ -663,6 +663,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;
     };
 }
@@ -670,41 +673,37 @@ export interface IReq_ControllerBrowserViewActivate extends plugins.typedrequest
     method: 'controller.browser.view.activate';
     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';
+export interface IReq_ControllerBrowserViewRecover extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ControllerBrowserViewRecover> {
+    method: 'controller.browser.view.recover';
     request: {
         viewId: string;
+        expectedStreamGeneration: number;
     };
     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;
+        resourceId: string;
+        attachmentRevision: number;
+        streamGeneration: number;
+        events: plugins.typedrequestInterfaces.TVirtualStream<'receive'>;
+        operations: plugins.typedrequestInterfaces.TVirtualStream<'send'>;
         state: IControllerBrowserViewState;
     };
 }
-/** Server to client push for one exact human browser view. */
-export interface IReq_ControllerBrowserViewEvent extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ControllerBrowserViewEvent> {
-    method: 'controller.browser.view.event';
+export interface IReq_ControllerBrowserViewClose extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ControllerBrowserViewClose> {
+    method: 'controller.browser.view.close';
     request: {
         viewId: string;
-        resourceId: string;
-        attachmentRevision: number;
-        event: TControllerBrowserViewEvent<'send'>;
+        expectedStreamGeneration: number;
+    };
+    response: {
+        closed: boolean;
     };
-    response: Record<string, never>;
 }
 export interface IReq_ControllerTerminalCreate extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_ControllerTerminalCreate> {
     method: 'controller.terminal.create';
@@ -803,4 +802,4 @@ export interface IReq_ControllerEvent extends plugins.typedrequestInterfaces.imp
         received: true;
     };
 }
-export type TControllerRequest = IReq_ControllerStatus | IReq_ControllerUpgradeLaunch | IReq_ControllerUpgradePrepare | IReq_ControllerUpgradePrepareBegin | IReq_ControllerUpgradeFinalize | IReq_ControllerSystemMetrics | IReq_ControllerAuthState | IReq_ControllerSetupBegin | IReq_ControllerSetupFinish | IReq_ControllerAuthenticationBegin | IReq_ControllerAuthenticationFinish | IReq_ControllerTempPasswordLogin | IReq_ControllerAuthResume | IReq_ControllerProjectList | IReq_ControllerProjectCreate | IReq_ControllerProjectRemove | IReq_ControllerProjectSuggest | IReq_ControllerProviderList | IReq_ControllerProviderConnectionList | IReq_ControllerProviderConnectionActivateOpenCode | IReq_ControllerProviderLoginBegin | IReq_ControllerProviderLoginGet | IReq_ControllerProviderLoginCancel | IReq_ControllerProviderConnectionLogout | IReq_ControllerProviderConnectionRateLimitsGet | IReq_ControllerProviderModelRefreshBegin | IReq_ControllerProviderModelRefreshGet | IReq_ControllerSlashList | IReq_ControllerSlashExecute | IReq_ControllerModelList | IReq_ControllerSettingsGet | IReq_ControllerSettingsUpdate | IReq_ControllerSessionList | IReq_ControllerSessionGet | IReq_ControllerSessionAuxiliaryGet | IReq_ControllerSessionModelUpdate | IReq_ControllerSessionScratchpadSave | IReq_ControllerSessionIntelligenceAsk | IReq_ControllerSessionMessagesPage | IReq_ControllerSessionMessageGet | IReq_ControllerSessionCreate | IReq_ControllerSessionDelete | IReq_ControllerSessionDiscardEmpty | IReq_ControllerSessionDraftGet | IReq_ControllerSessionDraftUpdate | IReq_ControllerSessionSend | IReq_ControllerSessionAbort | IReq_ControllerPermissionReply | IReq_ControllerQuestionReply | IReq_ControllerSessionRename | IReq_ControllerSessionArchive | IReq_ControllerSessionGroupsGet | IReq_ControllerSessionGroupsUpdate | IReq_ControllerSessionYolo | IReq_ControllerResourceList | IReq_ControllerResourceCreate | IReq_ControllerResourceRename | IReq_ControllerResourceAttach | IReq_ControllerResourceDetach | IReq_ControllerResourceRetire | IReq_ControllerResourceStart | IReq_ControllerResourceStop | IReq_ControllerBrowserViewOpen | IReq_ControllerBrowserViewActivate | IReq_ControllerBrowserViewClose | IReq_ControllerBrowserViewOperate | IReq_ControllerTerminalList | IReq_ControllerTerminalCreate | IReq_ControllerTerminalRename | IReq_ControllerTerminalRemove | IReq_ControllerTerminalAttach | IReq_ControllerTerminalDetach | IReq_ControllerTerminalInput | IReq_ControllerTerminalResize | IReq_ControllerTerminalOutput | IReq_ControllerBrowserViewEvent | IReq_ControllerEvent;
+export type TControllerRequest = IReq_ControllerStatus | IReq_ControllerUpgradeLaunch | IReq_ControllerUpgradePrepare | IReq_ControllerUpgradePrepareBegin | IReq_ControllerUpgradeFinalize | IReq_ControllerSystemMetrics | IReq_ControllerAuthState | IReq_ControllerSetupBegin | IReq_ControllerSetupFinish | IReq_ControllerAuthenticationBegin | IReq_ControllerAuthenticationFinish | IReq_ControllerTempPasswordLogin | IReq_ControllerAuthResume | IReq_ControllerProjectList | IReq_ControllerProjectCreate | IReq_ControllerProjectRemove | IReq_ControllerProjectSuggest | IReq_ControllerProviderList | IReq_ControllerProviderConnectionList | IReq_ControllerProviderConnectionActivateOpenCode | IReq_ControllerProviderLoginBegin | IReq_ControllerProviderLoginGet | IReq_ControllerProviderLoginCancel | IReq_ControllerProviderConnectionLogout | IReq_ControllerProviderConnectionRateLimitsGet | IReq_ControllerProviderModelRefreshBegin | IReq_ControllerProviderModelRefreshGet | IReq_ControllerSlashList | IReq_ControllerSlashExecute | IReq_ControllerModelList | IReq_ControllerSettingsGet | IReq_ControllerSettingsUpdate | IReq_ControllerSessionList | IReq_ControllerSessionGet | IReq_ControllerSessionAuxiliaryGet | IReq_ControllerSessionModelUpdate | IReq_ControllerSessionScratchpadSave | IReq_ControllerSessionIntelligenceAsk | IReq_ControllerSessionMessagesPage | IReq_ControllerSessionMessageGet | IReq_ControllerSessionCreate | IReq_ControllerSessionDelete | IReq_ControllerSessionDiscardEmpty | IReq_ControllerSessionDraftGet | IReq_ControllerSessionDraftUpdate | IReq_ControllerSessionSend | IReq_ControllerSessionAbort | IReq_ControllerPermissionReply | IReq_ControllerQuestionReply | IReq_ControllerSessionRename | IReq_ControllerSessionArchive | IReq_ControllerSessionGroupsGet | IReq_ControllerSessionGroupsUpdate | IReq_ControllerSessionYolo | IReq_ControllerResourceList | IReq_ControllerResourceCreate | IReq_ControllerResourceRename | IReq_ControllerResourceAttach | IReq_ControllerResourceDetach | IReq_ControllerResourceRetire | IReq_ControllerResourceStart | IReq_ControllerResourceStop | IReq_ControllerBrowserViewOpen | IReq_ControllerBrowserViewActivate | IReq_ControllerBrowserViewRecover | IReq_ControllerBrowserViewClose | IReq_ControllerTerminalList | IReq_ControllerTerminalCreate | IReq_ControllerTerminalRename | IReq_ControllerTerminalRemove | IReq_ControllerTerminalAttach | IReq_ControllerTerminalDetach | IReq_ControllerTerminalInput | IReq_ControllerTerminalResize | IReq_ControllerTerminalOutput | IReq_ControllerEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agl",
-  "version": "22.0.4",
+  "version": "24.0.0",
   "controllerUpgradeManagementVersion": 2,
   "private": false,
   "description": "Agent Gateway Layer for OpenCode and FlexHarness sessions",
@@ -19,16 +19,16 @@
     "@api.global/typedrequest": "8.0.2",
     "@api.global/typedrequest-interfaces": "7.1.0",
     "@api.global/typedserver": "11.1.0",
-    "@api.global/typedsocket": "8.0.0",
-    "@design.estate/dees-catalog": "6.10.2",
+    "@api.global/typedsocket": "8.0.1",
+    "@design.estate/dees-catalog": "6.12.1",
     "@design.estate/dees-element": "2.4.0",
-    "@modelprofile.com/browser-runtime": "3.0.1",
+    "@modelprofile.com/browser-runtime": "3.1.1",
     "@modelprofile.com/crossharness-mcp": "4.1.1",
-    "@modelprofile.com/flexharness": "4.1.2",
+    "@modelprofile.com/flexharness": "5.0.0",
     "@opencode-ai/sdk": "1.18.15",
     "@push.rocks/smartagent": "5.0.1",
     "@push.rocks/smartai": "6.0.0",
-    "@push.rocks/smartbrowser": "4.0.0",
+    "@push.rocks/smartbrowser": "4.0.1",
     "@push.rocks/smartcli": "4.3.0",
     "@push.rocks/smartdata": "11.6.1",
     "@push.rocks/smartdb": "5.2.1",
@@ -61,7 +61,7 @@
   },
   "devDependencies": {
     "@git.zone/tsbuild": "4.4.2",
-    "@git.zone/tsbundle": "2.11.4",
+    "@git.zone/tsbundle": "2.13.0",
     "@git.zone/tsrun": "2.0.6",
     "@git.zone/tstest": "4.0.0",
     "@types/node": "26.2.0"

package/readme.md

@@ -43,6 +43,12 @@ OpenCode and FlexHarness are supervised independently. Flex can restart without
 
 The browser receives normalized AGL data. It never receives the OpenCode server password, provider credentials, private database descriptors, raw provider responses, or Flex private snapshots.
 
+### Live Transcript Delivery
+
+Controller protocol v24 sends bounded live Assistant text and reasoning deltas when the browser already owns the exact preceding transcript revision. Every delta carries its stream epoch, revision, and UTF-8 coordinates; Flex deltas also carry the harness's authoritative transcript order. The browser applies only contiguous, correctly sized updates to the canonical transcript; a gap, stale owner, invalid coordinate, or queue overflow blocks further deltas from that epoch and requests authoritative session-detail hydration instead. Only adjacent compatible pending deltas may be coalesced, so interleaved updates retain their original order.
+
+Streaming text is rendered without Markdown parsing. AGL refreshes the affected messages and enables normal Markdown rendering after the harness reports terminal state or authoritative hydration settles the transcript. This keeps long responses responsive without creating a second browser-side message graph.
+
 ## Requirements
 
 - Node.js 24 or newer.
@@ -201,7 +207,11 @@ AGL allows at most eight running terminals per project and 32 controller-wide.
 
 ### Browsers
 
-A browser resource provides tabs, navigation, viewport control, mouse, keyboard, and text input through a human canvas. Frames use finite authenticated binary streams rather than public URLs or base64 JSON payloads.
+A browser resource provides tabs, navigation, viewport control, mouse, keyboard, and text input through a human canvas. Protocol v24 opens one authenticated persistent event stream and one paired operation stream for each human view. Every pair is bound to the exact peer, credential, resource authority, attachment revision, view, and stream generation.
+
+State and operation results use bounded JSON packets. A frame is sent as one validated metadata packet immediately followed by its raw image bytes, rather than through a public URL or base64 JSON payload. Operation IDs, pending bytes, acknowledgements, event delivery, input rates, and recovery attempts are all bounded. Only adjacent compatible pointer-move or viewport operations can be coalesced, while cancellation retains a separately fenced path to live work.
+
+The browser installs its renderer before activating a view. A recoverable stream failure suspends input, retires the old pair, opens and starts the next stream generation, and resumes the renderer's listeners before activating the replacement. Activation refreshes the runtime frame boundary, and input resumes only after that boundary arrives. Stale activation, recovery, cancellation, and close messages cannot act on another generation.
 
 When attached to a Flex conversation, the resource can provide permission-gated `navigate`, `snapshot`, `screenshot`, `click`, `fill`, and `press` actions to that exact run. Every channel is bound to the project, resource revision, session, run, actor, and current Flex generation.
 
@@ -317,7 +327,7 @@ Do not move these directories or edit migration and upgrade journals by hand.
 
 SmartData stores runtime configuration, passkey metadata, projects, layouts, model choices, scratchpads, tasks, goals, resources, Flex public projections, provider metadata, and bounded audit events. Prompt text is not written to audit records.
 
-Terminal I/O, active browser views, frame streams, composer drafts and their pending attachment state, active capability leases, and running processes remain memory-only. Once a prompt is submitted, attachment files exist only in private operation directories for the lifetime of that exact harness operation.
+Terminal I/O, active browser views and their paired transport streams, composer drafts and their pending attachment state, active capability leases, and running processes remain memory-only. Once a prompt is submitted, attachment files exist only in private operation directories for the lifetime of that exact harness operation.
 
 Library consumers can resolve the same home contract:
 

package/ts/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'
 }

package/ts/classes.authstore.ts

@@ -1246,7 +1246,7 @@ export class SmartDataAuthStore implements IAuthStore {
         name: nameArg,
         directory: directoryArg,
         directoryIdentityState: 'bound',
-        directoryIdentity: structuredClone(identityArg),
+        directoryIdentity: { ancestry: structuredClone(identityArg.ancestry) },
         createdAt: new Date(),
       };
       const result = await ControllerProjectModel.exact.insert(candidate);

package/ts/classes.browserresourcehost.ts

@@ -84,6 +84,7 @@ export interface IControllerBrowserResourceHostOptions {
 export interface IControllerBrowserHumanView {
   lease: plugins.browserRuntime.BrowserRuntimeLease;
   activate(listenerArg: (eventArg: plugins.browserRuntime.TBrowserRuntimeEvent) => void): Promise<void>;
+  refreshFrameStream(signalArg: AbortSignal): Promise<void>;
   close(): Promise<void>;
 }
 
@@ -854,6 +855,12 @@ export class ControllerBrowserResourceHost implements IControllerResourceRuntime
           });
           return activationPromise;
         },
+        refreshFrameStream: async (signalArg) => {
+          if (closing || !subscription || subscriptionClosed) {
+            throw new Error('The active browser frame subscription is unavailable.');
+          }
+          await lease.refreshFrameStream({ signal: signalArg });
+        },
         close: async () => {
           closing = true;
           const deadlineAt = Date.now() + this.cleanupTimeoutMs;