agl 22.0.4 → 23.0.0

package/dist_ts_interfaces/interfaces.d.ts

@@ -1,9 +1,10 @@
 import * as plugins from './plugins.js';
-export declare const controllerProtocolVersion: 22;
+export declare const controllerProtocolVersion: 23;
 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;
@@ -453,6 +454,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 +745,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 +760,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,10 @@
 import * as plugins from './plugins.js';
-export const controllerProtocolVersion = 22;
+export const controllerProtocolVersion = 23;
 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 +35,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 +47,4 @@ export const controllerEventTypes = [
     'terminals.changed',
     'upgrade.changed',
 ];
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxFQUFXLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsQ0FBVSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEtBQWMsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0sbUNBQW1DLEdBQUcsRUFBRSxDQUFDO0FBQ3RELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLEdBQUcsQ0FBQztBQUNuRCxNQUFNLENBQUMsTUFBTSxnQ0FBZ0MsR0FBRyxHQUFHLEdBQUcsSUFBSSxDQUFDO0FBQzNELE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUMxQyw4REFBdUUsQ0FBQztBQUMxRSxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLDZCQUE2QixHQUFHLENBQUMsQ0FBQztBQUMvQyxNQUFNLENBQUMsTUFBTSxpQ0FBaUMsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUNsRSxNQUFNLENBQUMsTUFBTSxzQ0FBc0MsR0FBRyxFQUFFLEdBQUcsSUFBSSxHQUFHLElBQUksQ0FBQztBQUN2RSxNQUFNLENBQUMsTUFBTSx3Q0FBd0MsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBRWxFLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxZQUFZLENBQVUsQ0FBQztBQUNoRixNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxDQUFDLFVBQVUsRUFBRSxNQUFNLENBQVUsQ0FBQztBQW1CekUsNkVBQTZFO0FBQzdFLE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLENBQUMsWUFBa0MsRUFBVSxFQUFFLENBQ25GLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxZQUFZLENBQUMsU0FBUyxFQUFFLFlBQVksQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDO0FBVWxFOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQUMsU0FBUyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFVLENBQUM7QUFvdEJ0Rjs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUc7SUFDbEMsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQix1QkFBdUI7SUFDdkIseUJBQXlCO0lBQ3pCLHNCQUFzQjtJQUN0QiwyQkFBMkI7SUFDM0Isc0JBQXNCO0lBQ3RCLHFCQUFxQjtJQUNyQixpQkFBaUI7SUFDakIsa0JBQWtCO0lBQ2xCLGtCQUFrQjtJQUNsQix1QkFBdUI7SUFDdkIsbUJBQW1CO0lBQ25CLG1CQUFtQjtJQUNuQixpQkFBaUI7Q0FDVCxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvaW50ZXJmYWNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxFQUFXLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sa0NBQWtDLEdBQUcsQ0FBVSxDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLEtBQWMsQ0FBQztBQUNwRCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLGtDQUFrQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0scUNBQXFDLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQztBQUMvRCxNQUFNLENBQUMsTUFBTSxtQ0FBbUMsR0FBRyxFQUFFLENBQUM7QUFDdEQsTUFBTSxDQUFDLE1BQU0sK0JBQStCLEdBQUcsR0FBRyxDQUFDO0FBQ25ELE1BQU0sQ0FBQyxNQUFNLGdDQUFnQyxHQUFHLEdBQUcsR0FBRyxJQUFJLENBQUM7QUFDM0QsTUFBTSxDQUFDLE1BQU0sK0JBQStCLEdBQzFDLDhEQUF1RSxDQUFDO0FBQzFFLE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsQ0FBQyxDQUFDO0FBQy9DLE1BQU0sQ0FBQyxNQUFNLGlDQUFpQyxHQUFHLEVBQUUsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDO0FBQ2xFLE1BQU0sQ0FBQyxNQUFNLHNDQUFzQyxHQUFHLEVBQUUsR0FBRyxJQUFJLEdBQUcsSUFBSSxDQUFDO0FBQ3ZFLE1BQU0sQ0FBQyxNQUFNLHdDQUF3QyxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUM7QUFFbEUsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLFlBQVksQ0FBVSxDQUFDO0FBQ2hGLE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLENBQUMsVUFBVSxFQUFFLE1BQU0sQ0FBVSxDQUFDO0FBbUJ6RSw2RUFBNkU7QUFDN0UsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsQ0FBQyxZQUFrQyxFQUFVLEVBQUUsQ0FDbkYsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLFlBQVksQ0FBQyxTQUFTLEVBQUUsWUFBWSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUM7QUFVbEU7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsQ0FBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQVUsQ0FBQztBQWd2QnRGOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRztJQUNsQyxrQkFBa0I7SUFDbEIsaUJBQWlCO0lBQ2pCLHVCQUF1QjtJQUN2Qix5QkFBeUI7SUFDekIsc0JBQXNCO0lBQ3RCLDJCQUEyQjtJQUMzQix5QkFBeUI7SUFDekIsc0JBQXNCO0lBQ3RCLG9CQUFvQjtJQUNwQixxQkFBcUI7SUFDckIsaUJBQWlCO0lBQ2pCLGtCQUFrQjtJQUNsQixrQkFBa0I7SUFDbEIsdUJBQXVCO0lBQ3ZCLG1CQUFtQjtJQUNuQixtQkFBbUI7SUFDbkIsaUJBQWlCO0NBQ1QsQ0FBQyJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agl",
-  "version": "22.0.4",
+  "version": "23.0.0",
   "controllerUpgradeManagementVersion": 2,
   "private": false,
   "description": "Agent Gateway Layer for OpenCode and FlexHarness sessions",
@@ -20,11 +20,11 @@
     "@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",
+    "@design.estate/dees-catalog": "6.12.1",
     "@design.estate/dees-element": "2.4.0",
     "@modelprofile.com/browser-runtime": "3.0.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",

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 v23 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.

package/ts/00_commitinfo_data.ts

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