agl 40.6.0 → 41.0.1

package/dist_ts_interfaces/fleetworkers.d.ts

@@ -304,6 +304,12 @@ export interface IFleetEvent {
     /** The native session (`harness:nativeId`) a ticket notice addressed. */
     sessionId?: string;
     reportId?: string;
+    /**
+     * The comment on `ticketKey` that holds this event's whole text, by the id the ticket board returned: a worker's report
+     * the fleet commented (`worker.report.mid_turn`, `worker.turn.ended`), the board pump's stall notice, a commented
+     * `ticket.changed`. Read it with `ticket_get` and `commentId`. Absent when no comment holds the text.
+     */
+    commentId?: string;
     turnId?: string;
     status?: string;
     text?: string;

package/dist_ts_interfaces/interfaces.d.ts

@@ -1,6 +1,6 @@
 import type { ILiveBrowserDialog, ILiveBrowserDialogResponse, ILiveVideoOffer, ILiveVideoDescription, ILiveVideoStatistics, ILiveVideoAcceleration } from '@push.rocks/smartbrowser/web';
 import type { IControllerBrowserPaintSource, IControllerBrowserPresentationState, TControllerBrowserPaintAvailability, TControllerBrowserPaintTermination } from './browserpaint.js';
-export declare const controllerProtocolVersion: 45;
+export declare const controllerProtocolVersion: 46;
 export declare const controllerUpgradeManagementVersion: 2;
 export declare const controllerPackageName: 'agl';
 /** The systemd user unit `agl service install` writes; a controller it runs reports it in its status. */

package/dist_ts_interfaces/interfaces.js

@@ -1,4 +1,4 @@
-export const controllerProtocolVersion = 45;
+export const controllerProtocolVersion = 46;
 export const controllerUpgradeManagementVersion = 2;
 export const controllerPackageName = 'agl';
 /** The systemd user unit `agl service install` writes; a controller it runs reports it in its status. */

package/dist_ts_interfaces/requests.tickets.d.ts

@@ -1,5 +1,5 @@
 import type * as plugins from './plugins.js';
-import type { ITicket, ITicketActivity, ITicketAnswer, ITicketAsk, ITicketBoard, ITicketChanges, ITicketComment, ITicketCreate, ITicketFilters, ITicketMove, ITicketQuestion, TTicketLink, TTicketOperation, TTicketReferenceContent, TTicketRequest, TTicketResponse } from './tickets.js';
+import type { ITicket, ITicketAnswer, ITicketAsk, ITicketBoard, ITicketChanges, ITicketComment, ITicketCreate, ITicketDetail, ITicketFilters, ITicketGet, ITicketMove, ITicketQuestion, TTicketLink, TTicketOperation, TTicketReferenceContent, TTicketRequest, TTicketResponse } from './tickets.js';
 export declare const controllerMcpTicketMethods: readonly ['agl.mcp.ticket.list', 'agl.mcp.ticket.board', 'agl.mcp.ticket.search', 'agl.mcp.ticket.get', 'agl.mcp.ticket.comments', 'agl.mcp.ticket.create', 'agl.mcp.ticket.update', 'agl.mcp.ticket.move', 'agl.mcp.ticket.comment', 'agl.mcp.ticket.link', 'agl.mcp.ticket.ask', 'agl.mcp.ticket.answer'];
 export type TControllerMcpTicketMethod = (typeof controllerMcpTicketMethods)[number];
 export type TControllerTicketRequest<TMethod extends TTicketOperation> = {
@@ -54,22 +54,18 @@ export interface IReq_ControllerMcpTicketSearch extends plugins.typedrequestInte
     };
 }
 /**
- * Reads a ticket by its `AGL-<n>` key, with its Markdown comments, source, links, questions and
- * their answers, and its complete activity log.
+ * Reads a ticket by its `AGL-<n>` key with its source, links, all its questions and their answers,
+ * and the newest page of its history (up to `limit` entries, default 50, at most 500, within 256 KiB), oldest first: the
+ * activity entries and the Markdown comments they name, a `commented` entry naming its comment by
+ * id. `historyBefore` is present while older history exists; pass it as `before` for the next page.
+ * `commentId` reads that one comment instead (`comments: [it]`, `activity: []`), without `before` or `limit`.
  */
 export interface IReq_ControllerMcpTicketGet extends plugins.typedrequestInterfaces.implementsTR<TControllerMcpTicketRequest<'get'>, IReq_ControllerMcpTicketGet> {
     method: 'agl.mcp.ticket.get';
-    request: {
-        ticketId: string;
-    } & {
+    request: ITicketGet & {
         ownerToken?: string;
     };
-    response: {
-        ticket: ITicket;
-        comments: ITicketComment[];
-        activity: ITicketActivity[];
-        questions: ITicketQuestion[];
-    };
+    response: ITicketDetail;
 }
 /** Reads a ticket's comments. */
 export interface IReq_ControllerMcpTicketComments extends plugins.typedrequestInterfaces.implementsTR<TControllerMcpTicketRequest<'comments'>, IReq_ControllerMcpTicketComments> {

package/dist_ts_interfaces/tickets.d.ts

@@ -218,6 +218,40 @@ export interface ITicketMove {
     columnId: TTicketColumn;
     beforeTicketId?: string;
 }
+/**
+ * How many history entries one `get` returns unless it names `limit`, the most it may name, and the bytes a page holds
+ * at most (its entries plus the comments they name, serialized; a page holds at least one entry). The budget wins over `limit`.
+ */
+export declare const ticketHistoryPage: {
+    readonly default: 50;
+    readonly maximum: 500;
+    readonly bytes: number;
+};
+/** A ticket and one page of its history: the newest entries, or those older than the entry `before` names, within `ticketHistoryPage`. */
+export interface ITicketGet {
+    ticketId: string;
+    /** An activity id, as `historyBefore` returned it: the page holds only older entries. */
+    before?: string;
+    /** Entries on the page, 1 to 500 (`ticketHistoryPage.maximum`); 50 (`ticketHistoryPage.default`) when absent. */
+    limit?: number;
+    /**
+     * One comment of this ticket, by the id an activity entry or a fleet event names: the response holds the ticket, its
+     * questions and that comment alone (`comments: [it]`, `activity: []`, no `historyBefore`). Excludes `before` and `limit`.
+     */
+    commentId?: string;
+}
+/**
+ * A ticket, all its questions and one page of its history, oldest first. `activity` is the page; `comments` are the
+ * comments its `commented` entries name, whose `changes.comment` holds only `{ after: { id } }` here (the stored
+ * entry keeps the whole comment). `historyBefore` is present while older entries exist: pass it as `before`.
+ */
+export interface ITicketDetail {
+    ticket: ITicket;
+    comments: ITicketComment[];
+    activity: ITicketActivity[];
+    questions: ITicketQuestion[];
+    historyBefore?: string;
+}
 export interface ITicketBoard {
     revision: number;
     columns: {
@@ -250,15 +284,8 @@ export interface ITicketOperations {
         };
     };
     get: {
-        request: {
-            ticketId: string;
-        };
-        response: {
-            ticket: ITicket;
-            comments: ITicketComment[];
-            activity: ITicketActivity[];
-            questions: ITicketQuestion[];
-        };
+        request: ITicketGet;
+        response: ITicketDetail;
     };
     comments: {
         request: {
@@ -369,6 +396,7 @@ export declare const ticketErrorMessages: {
     readonly ticket_ask_forbidden: 'Workers may ask questions only on tickets assigned to their verified session.';
     readonly ticket_answer_forbidden: 'Only the owner or the driver may answer ticket questions.';
     readonly ticket_question_not_found: 'The requested question does not exist on this ticket.';
+    readonly ticket_comment_not_found: 'The requested comment does not exist on this ticket.';
     readonly ticket_question_answered: 'The question already has a different answer; a second answer is refused. Ask a new question instead.';
     readonly ticket_answer_invalid: 'An answer chooses existing option ids (one unless multiSelect) and/or gives free text where the question allows it.';
 };

package/dist_ts_interfaces/tickets.js

@@ -43,6 +43,11 @@ export const ticketAnswerFromCard = (questionArg, answersArg) => {
     return { choices: questionArg.options.filter((optionArg) => choices.includes(optionArg.id)).map((optionArg) => optionArg.id),
         ...(texts.length ? { text: texts.join('\n\n') } : {}) };
 };
+/**
+ * How many history entries one `get` returns unless it names `limit`, the most it may name, and the bytes a page holds
+ * at most (its entries plus the comments they name, serialized; a page holds at least one entry). The budget wins over `limit`.
+ */
+export const ticketHistoryPage = { default: 50, maximum: 500, bytes: 256 * 1024 };
 export const ticketErrorMessages = {
     ticket_revision_conflict: 'The ticket changed since editing began. Reload it before editing again.',
     ticket_identity_required: 'A verified MCP caller is required for this ticket operation. Unidentified callers may only list or get tickets.',
@@ -59,9 +64,10 @@ export const ticketErrorMessages = {
     ticket_ask_forbidden: 'Workers may ask questions only on tickets assigned to their verified session.',
     ticket_answer_forbidden: 'Only the owner or the driver may answer ticket questions.',
     ticket_question_not_found: 'The requested question does not exist on this ticket.',
+    ticket_comment_not_found: 'The requested comment does not exist on this ticket.',
     ticket_question_answered: 'The question already has a different answer; a second answer is refused. Ask a new question instead.',
     ticket_answer_invalid: 'An answer chooses existing option ids (one unless multiSelect) and/or gives free text where the question allows it.',
 };
 export const ticketClientErrorMessages = Object.fromEntries(Object.entries(ticketErrorMessages)
     .map(([codeArg, messageArg]) => [codeArg.toUpperCase(), messageArg]));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGlja2V0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvdGlja2V0cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUc7SUFDM0IsU0FBUyxFQUFFLE9BQU8sRUFBRSxhQUFhLEVBQUUsYUFBYSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsVUFBVTtDQUN4RSxDQUFDO0FBaURYLHNGQUFzRjtBQUN0RixNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLGNBQWMsQ0FBVSxDQUFDO0FBRTFELE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLENBQUMsUUFBZ0IsRUFBZ0MsRUFBRSxDQUFDLENBQ2xGLGdCQUFzQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsQ0FDM0QsQ0FBQztBQUtGLE1BQU0sQ0FBQyxNQUFNLDBCQUEwQixHQUFHLENBQUMsUUFBaUIsRUFBdUMsRUFBRTtJQUNuRyxJQUFJLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLEtBQUssSUFBSTtRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3hFLE1BQU0sS0FBSyxHQUFHLFFBQTRDLENBQUM7SUFDM0QsT0FBTyxLQUFLLENBQUMsSUFBSSxLQUFLLDBCQUEwQixJQUFJLE1BQU0sQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLGVBQWUsQ0FBQyxJQUFJLEtBQUssQ0FBQyxlQUFnQixJQUFJLENBQUM7UUFDNUgsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLDBCQUEwQixFQUFFLGVBQWUsRUFBRSxLQUFLLENBQUMsZUFBZ0IsRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7QUFDaEcsQ0FBQyxDQUFDO0FBMkVGLDhGQUE4RjtBQUM5RixNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxDQUFDLFdBQTRCLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDMUUsRUFBRSxFQUFFLFdBQVcsQ0FBQyxFQUFFO0lB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGlja2V0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2ludGVyZmFjZXMvdGlja2V0cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUc7SUFDM0IsU0FBUyxFQUFFLE9BQU8sRUFBRSxhQUFhLEVBQUUsYUFBYSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsVUFBVTtDQUN4RSxDQUFDO0FBaURYLHNGQUFzRjtBQUN0RixNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLGNBQWMsQ0FBVSxDQUFDO0FBRTFELE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLENBQUMsUUFBZ0IsRUFBZ0MsRUFBRSxDQUFDLENBQ2xGLGdCQUFzQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsQ0FDM0QsQ0FBQztBQUtGLE1BQU0sQ0FBQyxNQUFNLDBCQUEwQixHQUFHLENBQUMsUUFBaUIsRUFBdUMsRUFBRTtJQUNuRyxJQUFJLE9BQU8sUUFBUSxLQUFLLFFBQVEsSUFBSSxRQUFRLEtBQUssSUFBSTtRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3hFLE1BQU0sS0FBSyxHQUFHLFFBQTRDLENBQUM7SUFDM0QsT0FBTyxLQUFLLENBQUMsSUFBSSxLQUFLLDBCQUEwQixJQUFJLE1BQU0sQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLGVBQWUsQ0FBQyxJQUFJLEtBQUssQ0FBQyxlQUFnQixJQUFJLENBQUM7UUFDNUgsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLDBCQUEwQixFQUFFLGVBQWUsRUFBRSxLQUFLLENBQUMsZUFBZ0IsRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7QUFDaEcsQ0FBQyxDQUFDO0FBMkVGLDhGQUE4RjtBQUM5RixNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxDQUFDLFdBQTRCLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDMUUsRUFBRSxFQUFFLFdBQVcsQ0FBQyxFQUFFO0lB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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agl",
-  "version": "40.6.0",
+  "version": "41.0.1",
   "controllerUpgradeManagementVersion": 2,
   "private": false,
   "description": "Agent Gateway Layer for OpenCode, FlexHarness, and Codex sessions",
@@ -24,7 +24,7 @@
     "@api.global/typedsocket": "8.10.0",
     "@apiclient.xyz/docker": "10.1.3",
     "@aws-sdk/client-s3": "^3.1136.0",
-    "@design.estate/dees-catalog": "^23.1.0",
+    "@design.estate/dees-catalog": "^23.4.0",
     "@design.estate/dees-comms": "^2.1.0",
     "@design.estate/dees-element": "4.0.2",
     "@jitl/quickjs-ng-wasmfile-release-sync": "0.32.0",
@@ -32,11 +32,11 @@
     "@lossless.org/nosqldb": "10.8.0",
     "@lossless.org/objectstorage": "10.7.1",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@modelprofile.com/catalog": "^1.0.0",
-    "@modelprofile.com/flexharness": "16.3.0",
-    "@modelprofile.com/flexharness-agent": "16.3.0",
-    "@modelprofile.com/flexharness-models": "16.3.0",
-    "@modelprofile.com/flexharness-providers": "16.3.0",
+    "@modelprofile.com/catalog": "^1.1.0",
+    "@modelprofile.com/flexharness": "16.4.0",
+    "@modelprofile.com/flexharness-agent": "16.4.0",
+    "@modelprofile.com/flexharness-models": "16.4.0",
+    "@modelprofile.com/flexharness-providers": "16.4.0",
     "@modelprofile.com/mcp-crossharness": "5.9.0",
     "@modelprofile.com/mcp-system": "3.1.0",
     "@opencode-ai/sdk": "1.18.15",

package/readme.md

@@ -76,6 +76,8 @@ The browser receives normalized AGL data. It never receives the OpenCode server
 
 Controller protocol v28 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.
 
+Each browser receives controller events through its own ordered queue, one event in flight at a time, so a tab that acknowledges slowly or not at all delays only itself. A queue that passes 512 events or 16 MiB collapses for that browser alone: it keeps the newest event of each state, drops live text, reasoning and tool content, and ends with a conversation refresh for each harness whose live content it dropped. A streamed Flex reply notifies a conversation change at its parts' starts and ends and its run's lifecycle, not with every delta.
+
 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.
 
 Consecutive Assistant messages containing only reasoning share one header and time range. Each thought keeps its own disclosure and active thinking state; user messages, text, tools and attention requests end the group.
@@ -1274,7 +1276,12 @@ native completion; archive requires a settled worker. A worker whose start was r
 native session, and archiving it touches no harness. Claude archive marks only the AGL
 registry, preserving the transcript and native worktree. Codex archives its native thread.
 Watch retains native `reportId` alongside `workerId` so consumers can correlate reports
-and updates without treating each watch cursor as a new report. A failed observation, a
+and updates without treating each watch cursor as a new report. An event whose whole text is a
+ticket comment names it as `commentId`: the fleet comments a ticketed worker's report before it
+publishes the report's event (`worker.report.mid_turn`, `worker.turn.ended`), the board pump's
+`ticket.stalled` names its notice, and a commented `ticket.changed` its comment. Read it with
+`ticket_get` and `commentId` (`agl ticket get AGL-<n> --comment <id>`), however long the
+ticket's history is. A report whose comment was not written names none. A failed observation, a
 transcript gap for example, is published once as `worker.observation.failed`; the fleet then
 requests a fresh report itself: the worker's next poll starts from a new baseline, and its
 newest report, when it has one, is published as `worker.report.mid_turn` and commented on its
@@ -1594,8 +1601,13 @@ While the board changed within the last hour, the driver keeps its prompt cache
 next turn reads the cached prefix instead of writing it again. Every board change (a ticket
 created, changed, moved, commented, answered or assigned) sets the driver session's warm
 deadline to one hour from then, and Flex runs a warm-up turn before the provider's cache would
-expire. An hour after the last board change, warming stops until the next one. Warm-up turns
-add nothing to the driver's conversation: no message in its transcript, no `working` status,
+expire. On a Claude model the driver's requests ask Anthropic for one-hour cache breakpoints
+(`cache: { retention: '1h' }`), so an idle hour costs one warm-up turn, a minute before the hour
+ends, instead of one every four minutes; writing an hour's breakpoint costs 2× the input price
+instead of 1.25×. Other sessions keep the five-minute default for their newest breakpoint. On a
+ChatGPT account the cache lives in memory for about five minutes and takes no retention, so
+warm-up turns still come every four minutes. An hour after the last board change, warming stops until the next one. Warm-up turns
+add nothing to the driver's conversation: nothing its model sees on later turns, no message in its transcript, no `working` status,
 no unread turn and no batch of fleet events. They leave the session's state as its last real
 turn left it, so a driver whose last turn failed still shows that error. The controller logs each
 warm-up turn with the tokens it read from the cache. `keepCacheWarm: false` turns warming off
@@ -1615,8 +1627,14 @@ and `driver_notes_update`, the shell and file tools
 every Flex session has, and the [AGL API](#agl-api-for-flex-sessions) without its ticket methods. The controller runs each of these tool calls as the driver: actor
 `driver:<controller id>` with the ticket role `driver`. A tool that changes fleet or ticket
 state first asks for the `agl.driver` permission, which the session can remember. The notes
-are the driver session's scratchpad. They are added to its system prompt on every run, so the
-driver's working state survives compaction and restarts.
+are the driver session's scratchpad, so the driver's working state survives compaction and
+restarts. They are not part of the driver's system prompt, which holds its instructions only:
+they reach the model as Flex's pinned context `driver-notes`, named by the scratchpad's
+revision. A turn whose context does not show the current revision gets it right before its
+prompt, and a compaction ends its summary with it, so the driver sees its notes when they change
+and after a compaction, and a notes update leaves the cached prompt in front of it unchanged.
+Empty notes are pinned as a note that they are empty, so clearing them replaces the text saved
+before.
 
 `ticket_question_answer` records the owner's answer to an open ticket question as the driver,
 with the schema of `agl ticket answer`; the MCP server has no such tool, so a worker cannot
@@ -1645,7 +1663,15 @@ finished or failed releases, failed or unknown ticket effects, others' ticket ch
 (`ticket.notification.failed`, naming the session), stalled tickets the board pump found
 (`ticket.stalled`) and Claude Code releases newer than the verified one
 (`harness.release.discovered`). Worker status changes, host-load samples,
-applied ticket effects and delivered ticket notices are not delivered. A batch waits 15
+applied ticket effects and delivered ticket notices are not delivered. Each event reads as one
+header line -- `- [event <id>] <time> <kind>` with its ticket, worker, session, report id, turn id,
+status, repo, version and operation -- then its error and its text, quoted. A text longer than
+3 KiB is relayed as a digest: every report marker line (`result:`, `needs input:`, `owner
+question:` and the others the fleet reads as a report), each at most 1 KiB, then the text's end,
+in order, with `[… N lines …]` where lines were left out. A note then says where the whole text
+is: a ticketed worker's report is the fleet comment of that report id on its ticket, and a
+stalled ticket's notice or another's change is on its ticket, all read with `ticket_get`. A
+report longer than 32 KiB is kept by the fleet from its end only, which the note says. A batch waits 15
 seconds for further events and is delivered at most once a minute. It waits while the driver runs a turn, including permission waits, using the current session state.
 If a batch is still queued when further events arrive, they merge into that same message,
 keeping its position and sender. The merged text is stored before the merge is acknowledged,
@@ -1698,6 +1724,10 @@ as `ticket.notified` when the answers reached the worker, and reaches the driver
 relay. The pump never starts a worker, never moves a ticket and never answers a question, and its
 comments are not relayed to the assignee as ticket notices.
 
+Each pass reads the board list once. A ticket's history and questions are read again only when its
+revision moved since the pass that last read them; every comment, question, answer and other change
+moves it, so a pass over an unchanged board reads no ticket's history.
+
 The pump is on by default; configure it in the Configuration master:
 
 ```json
@@ -1730,8 +1760,8 @@ has full access; the CLI reuses `agl config`'s short-lived local-owner capabilit
 is no automatic dispatch. Attachment URLs must use HTTP or HTTPS; AGL stores the
 reference and does not fetch its payload.
 
-Unidentified local MCP callers may use `tickets_list` and `ticket_get`, including comments
-and activity returned with the ticket. Their Mine filter is empty and every returned ticket
+Unidentified local MCP callers may use `tickets_list` and `ticket_get`, including the comments
+and activity of the history page returned with the ticket. Their Mine filter is empty and every returned ticket
 permission is false. Every mutation refuses with `TICKET_IDENTITY_REQUIRED`; neither a
 claimed name nor a native session id supplies identity. Plain Claude background sessions
 started outside AGL stay unidentified. The web board still requires owner authentication.
@@ -1845,11 +1875,14 @@ that worker, not as the driver or anonymously:
   When the inventory shows the worker's session as another job, or the fleet no longer binds
   the worker to it (archived, moved to another session), the launch is revoked for good.
   An upgrade moves every bridge in place onto the new build (`process.execve`: the same PID and
-  start, a new image from the new install's path), and the image it became is proved afresh:
-  its command is the one recorded with the launch or the one the restarted controller resolves
-  itself from its configured `agl` MCP entry, never one the bridge names, and a new command is
-  kept with the binding's next revision. Each reason an enrollment stays unverified is written once to the controller log,
-  naming the worker and its session, never the launch ID or a credential.
+  start, a new image `node <new cli.js> mcp --port <port>` from the new install's path), and the
+  image it became is proved afresh: its command is the one recorded with the launch or the one
+  the restarted controller resolves itself from its configured `agl` MCP entry, never one the
+  bridge names, and a new command is kept with the binding's next revision. Its arguments are
+  that command's or exactly `mcp --port <port>` with the port the controller is configured
+  with. Each reason an enrollment stays unverified is written once to the controller log,
+  naming the worker and its session, never the launch ID or a credential; a bridge refused
+  under both commands has both reasons, the recorded command's first.
 
 The bridge exchanges credentials only through the private controller endpoint after Linux
 direct-loopback socket-inode ownership, approved executable/argv and current native
@@ -1865,7 +1898,7 @@ entry. Ambiguous entries, wrapper commands, static caller credentials and secret
 definitions fail closed. Fleet owns spawning, native observations and hook calls.
 
 MCP tools are `tickets_list` (mine/project/status/label/text filters), `ticket_get` (ticket,
-comments, complete activity and questions), `ticket_create`, `ticket_update`, `ticket_move`,
+questions and one page of history), `ticket_create`, `ticket_update`, `ticket_move`,
 `ticket_comment`, `ticket_link` and `ticket_question_ask`. `ticket_comment.body` accepts markdown text or the
 kanban's text/reference-content array. A Claude worker's assignment uses
 `claude:<agent-session-id>` and a Codex worker's uses `codex:<native-id>`; the same value
@@ -1881,6 +1914,8 @@ agl ticket list --project agl --json
 agl ticket link AGL-1 --repo modelprofile.com/agl --branch feat/tickets --sha <full-sha> --json
 agl ticket move AGL-1 --column review --json
 agl ticket get AGL-1 --json
+agl ticket get AGL-1 --limit 20 --before <historyBefore> --json
+agl ticket get AGL-1 --comment <comment-id> --json
 agl ticket comment AGL-1 --body '**Checks passed**' --json
 agl ticket update AGL-1 --expected-revision <revision-from-get> --changes '{"priority":"high","labels":["backend"]}' --json
 agl ticket ask AGL-1 --text 'Which store?' --options '["Memory",{"label":"Database","description":"Durable"}]' --json
@@ -1888,6 +1923,18 @@ agl ticket list --label openQuestion --json
 agl ticket answer AGL-1 --question Q1 --choice 2 --text 'Keep it **small**.' --json
 ```
 
+`ticket_get` (`agl ticket get`, `agl.mcp.ticket.get`, `controller.ticket.get`) returns the
+ticket, all its questions and the newest page of its history, oldest first: `activity` holds
+up to `limit` entries (default 50, at most 500), cut earlier so that the entries and the comments
+they name stay within 256 KiB (always at least one entry), and `comments` the comments those
+entries name. A `commented` entry names its comment as `changes.comment: { after: { id } }`, so
+each comment body appears once (stored activity keeps the whole comment). While older history exists the response
+carries `historyBefore`; pass it as `before` (`--before`) to read the next older page. To read the
+one comment an activity entry or a fleet event names, pass its id as `commentId` (`--comment`)
+instead: the answer holds the ticket, its questions and that comment alone (`activity` empty, no
+`historyBefore`); it cannot be combined with `before` or `limit`, and an id that is not a comment
+of the ticket is refused with `ticket_comment_not_found`. The board in the browser reads every page.
+
 All ten CLI actions accept `--port` and `--json`; `agl ticket --help` documents their
 options. The running controller is required. `update` and `assign` require `--expected-revision`
 from the ticket the editor read; neither command fetches a newer revision before saving.
@@ -2370,7 +2417,7 @@ Deleting a managed OpenCode conversation deletes the selected OpenCode conversat
 
 ### Models And Provider Accounts
 
-AGL stores an independent default model for OpenCode, FlexHarness, Codex and Claude Code. A conversation can override its harness default without changing other conversations.
+AGL stores an independent default model for OpenCode, FlexHarness, Codex and Claude Code. A conversation can override its harness default without changing other conversations. **Settings → General** shows each harness's default as one button that says the model and its effort (`openai/gpt-5.6-sol · max`, without the harness the row already names) and opens both choices in a speech bubble; a saved default the harness no longer offers gives the button the warning tone.
 
 A stored default names a model as the harness offered it then, so AGL resolves it against the harness's live model list whenever a conversation is created or sent without a model of its own. While the harness offers it, it is sent. A stored default the harness no longer offers is never sent: the harness's own default stands in -- OpenCode's or Codex's configured model, or for Flex the catalog default of the account placement takes -- and when the harness offers no default AGL can name, OpenCode, Codex and Claude Code run their own default unnamed, while Flex, which has none of its own, asks for an account and model in the composer. The stored setting stays as the owner wrote it; `models_list` reports it as `unavailableSetting`, and Settings says under the default model that it is no longer offered and what new conversations run on instead.
 

package/ts/00_commitinfo_data.ts

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

package/ts/aglapi/aglapisurface.document.ts

@@ -1408,8 +1408,8 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
     {
       "method": "agl.mcp.ticket.get",
       "path": "agl.agl_mcp_ticket_get",
-      "summary": "Reads a ticket by its `AGL-<n>` key, with its Markdown comments, source, links, questions and their answers, and its co…",
-      "description": "Reads a ticket by its `AGL-<n>` key, with its Markdown comments, source, links, questions and\ntheir answers, and its complete activity log.",
+      "summary": "Reads a ticket by its `AGL-<n>` key with its source, links, all its questions and their answers, and the newest page of…",
+      "description": "Reads a ticket by its `AGL-<n>` key with its source, links, all its questions and their answers,\nand the newest page of its history (up to `limit` entries, default 50, at most 500, within 256 KiB), oldest first: the\nactivity entries and the Markdown comments they name, a `commented` entry naming its comment by\nid. `historyBefore` is present while older history exists; pass it as `before` for the next page.\n`commentId` reads that one comment instead (`comments: [it]`, `activity: []`), without `before` or `limit`.",
       "omitted": [
         "ownerToken"
       ],
@@ -1419,6 +1419,18 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
         "properties": {
           "ticketId": {
             "type": "string"
+          },
+          "before": {
+            "type": "string",
+            "description": "An activity id, as `historyBefore` returned it: the page holds only older entries."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Entries on the page, 1 to 500 (`ticketHistoryPage.maximum`); 50 (`ticketHistoryPage.default`) when absent."
+          },
+          "commentId": {
+            "type": "string",
+            "description": "One comment of this ticket, by the id an activity entry or a fleet event names: the response holds the ticket, its questions and that comment alone (`comments: [it]`, `activity: []`, no `historyBefore`). Excludes `before` and `limit`."
           }
         },
         "required": [
@@ -1426,39 +1438,9 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
         ]
       },
       "outputSchema": {
-        "type": "object",
-        "properties": {
-          "ticket": {
-            "$ref": "#/$defs/ITicket"
-          },
-          "comments": {
-            "type": "array",
-            "items": {
-              "$ref": "#/$defs/ITicketComment"
-            }
-          },
-          "activity": {
-            "type": "array",
-            "items": {
-              "$ref": "#/$defs/ITicketActivity"
-            }
-          },
-          "questions": {
-            "type": "array",
-            "items": {
-              "$ref": "#/$defs/ITicketQuestion"
-            }
-          }
-        },
-        "required": [
-          "ticket",
-          "comments",
-          "activity",
-          "questions"
-        ],
-        "additionalProperties": false
+        "$ref": "#/$defs/ITicketDetail"
       },
-      "declaration": "/**\n * Reads a ticket by its `AGL-<n>` key, with its Markdown comments, source, links, questions and\n * their answers, and its complete activity log.\n */\nfunction agl_mcp_ticket_get(params: { ticketId: string }): Promise<{ ticket: ITicket; comments: ITicketComment[]; activity: ITicketActivity[]; questions: ITicketQuestion[] }>;"
+      "declaration": "/**\n * Reads a ticket by its `AGL-<n>` key with its source, links, all its questions and their answers,\n * and the newest page of its history (up to `limit` entries, default 50, at most 500, within 256 KiB), oldest first: the\n * activity entries and the Markdown comments they name, a `commented` entry naming its comment by\n * id. `historyBefore` is present while older history exists; pass it as `before` for the next page.\n * `commentId` reads that one comment instead (`comments: [it]`, `activity: []`), without `before` or `limit`.\n */\nfunction agl_mcp_ticket_get(params: ITicketGet): Promise<ITicketDetail>;"
     },
     {
       "method": "agl.mcp.ticket.link",
@@ -3783,7 +3765,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
           },
           "protocolVersion": {
             "type": "number",
-            "const": 45
+            "const": 46
           },
           "upgradeManagementVersion": {
             "type": "number"
@@ -3905,7 +3887,7 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
         ],
         "additionalProperties": false
       },
-      "declaration": "interface IControllerStatus {\n  packageName: string;\n  packageVersion: string;\n  protocolVersion: 45;\n  upgradeManagementVersion: number;\n  controllerPid: number;\n  processGroupId: number;\n  processFingerprint: string;\n  processMode: TControllerProcessMode;\n  lifecycleState: TControllerLifecycleState;\n  startedAt: number;\n  setupRequired: boolean;\n  /** Present when the controller runs as the systemd user unit (`agl service install`); absent for a detached or foreground one. */\n  serviceUnit?: \"agl-controller.service\";\n  /** The TLS mode of the runtime configuration the controller runs with; absent until it is resolved. */\n  tlsMode?: TControllerTlsMode;\n  upgrade?: IControllerUpgradeStatus;\n  /** AGL's inference proxy, by state only; details need a signed-in owner (`controller.proxy.status.get`). */\n  proxy?: { state: TControllerProxyState };\n  harnesses: Array<{\n    harnessId: TControllerSessionHarnessId;\n    pid?: number;\n    state: TControllerHarnessLifecycleState;\n    healthy: boolean;\n    version?: string;\n    supportsLocalAttachments?: boolean;\n    connectionMode?: 'local' | 'shared' | 'remote';\n    diagnostic?: IControllerCodexDiagnostic;\n    /** Codex only: automatic reconnection of this entry's profile to the local shared app-server. */\n    rejoin?: IControllerCodexRejoinStatus;\n    /**\n     * Codex only, on the controller status: every connected or required profile. The entry's\n     * `healthy` is then true only when each of them is, apart from a profile on an account Codex\n     * cannot run on now, listed `stopped` with an `account_unavailable` diagnostic that says why;\n     * its other members describe the default profile.\n     */\n    profiles?: IControllerCodexProfileStatus[];\n  }>;\n}"
+      "declaration": "interface IControllerStatus {\n  packageName: string;\n  packageVersion: string;\n  protocolVersion: 46;\n  upgradeManagementVersion: number;\n  controllerPid: number;\n  processGroupId: number;\n  processFingerprint: string;\n  processMode: TControllerProcessMode;\n  lifecycleState: TControllerLifecycleState;\n  startedAt: number;\n  setupRequired: boolean;\n  /** Present when the controller runs as the systemd user unit (`agl service install`); absent for a detached or foreground one. */\n  serviceUnit?: \"agl-controller.service\";\n  /** The TLS mode of the runtime configuration the controller runs with; absent until it is resolved. */\n  tlsMode?: TControllerTlsMode;\n  upgrade?: IControllerUpgradeStatus;\n  /** AGL's inference proxy, by state only; details need a signed-in owner (`controller.proxy.status.get`). */\n  proxy?: { state: TControllerProxyState };\n  harnesses: Array<{\n    harnessId: TControllerSessionHarnessId;\n    pid?: number;\n    state: TControllerHarnessLifecycleState;\n    healthy: boolean;\n    version?: string;\n    supportsLocalAttachments?: boolean;\n    connectionMode?: 'local' | 'shared' | 'remote';\n    diagnostic?: IControllerCodexDiagnostic;\n    /** Codex only: automatic reconnection of this entry's profile to the local shared app-server. */\n    rejoin?: IControllerCodexRejoinStatus;\n    /**\n     * Codex only, on the controller status: every connected or required profile. The entry's\n     * `healthy` is then true only when each of them is, apart from a profile on an account Codex\n     * cannot run on now, listed `stopped` with an `account_unavailable` diagnostic that says why;\n     * its other members describe the default profile.\n     */\n    profiles?: IControllerCodexProfileStatus[];\n  }>;\n}"
     },
     {
       "name": "IControllerTerminalResource",
@@ -4743,10 +4725,55 @@ export const AGL_API_SURFACE: plugins.flexTypedRequest.IFlexTypedRequestSurface
       "name": "ITicketCreate",
       "declaration": "interface ITicketCreate {\n  project: string;\n  kind?: TTicketKind;\n  title: string;\n  description?: string;\n  columnId?: TTicketColumn;\n  parentId?: string;\n  priority?: TTicketPriority;\n  assignee?: ITicketPerson;\n  labels?: string[];\n  sourceText?: string;\n  attachments?: ITicketAttachment[];\n}"
     },
+    {
+      "name": "ITicketDetail",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "ticket": {
+            "$ref": "#/$defs/ITicket"
+          },
+          "comments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/ITicketComment"
+            }
+          },
+          "activity": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/ITicketActivity"
+            }
+          },
+          "questions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/ITicketQuestion"
+            }
+          },
+          "historyBefore": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "ticket",
+          "comments",
+          "activity",
+          "questions"
+        ],
+        "additionalProperties": false,
+        "description": "A ticket, all its questions and one page of its history, oldest first. `activity` is the page; `comments` are the comments its `commented` entries name, whose `changes.comment` holds only `{ after: { id } }` here (the stored entry keeps the whole comment). `historyBefore` is present while older entries exist: pass it as `before`."
+      },
+      "declaration": "/**\n * A ticket, all its questions and one page of its history, oldest first. `activity` is the page; `comments` are the\n * comments its `commented` entries name, whose `changes.comment` holds only `{ after: { id } }` here (the stored\n * entry keeps the whole comment). `historyBefore` is present while older entries exist: pass it as `before`.\n */\ninterface ITicketDetail {\n  ticket: ITicket;\n  comments: ITicketComment[];\n  activity: ITicketActivity[];\n  questions: ITicketQuestion[];\n  historyBefore?: string;\n}"
+    },
     {
       "name": "ITicketFilters",
       "declaration": "interface ITicketFilters {\n  mine?: boolean;\n  project?: string;\n  status?: TTicketColumn;\n  /** Matches a hand label or an AutoLabel. */\n  label?: string;\n  text?: string;\n}"
     },
+    {
+      "name": "ITicketGet",
+      "declaration": "/** A ticket and one page of its history: the newest entries, or those older than the entry `before` names, within `ticketHistoryPage`. */\ninterface ITicketGet {\n  ticketId: string;\n  /** An activity id, as `historyBefore` returned it: the page holds only older entries. */\n  before?: string;\n  /** Entries on the page, 1 to 500 (`ticketHistoryPage.maximum`); 50 (`ticketHistoryPage.default`) when absent. */\n  limit?: number;\n  /**\n   * One comment of this ticket, by the id an activity entry or a fleet event names: the response holds the ticket, its\n   * questions and that comment alone (`comments: [it]`, `activity: []`, no `historyBefore`). Excludes `before` and `limit`.\n   */\n  commentId?: string;\n}"
+    },
     {
       "name": "ITicketMove",
       "declaration": "interface ITicketMove { ticketId: string; columnId: TTicketColumn; beforeTicketId?: string; }"