@myagentroam/agent 0.9.62 → 0.9.64

package/dist/sdk/types.d.ts

@@ -1,6 +1,8 @@
 import type { HostDescription } from '../host/contracts.js';
 import type { MarAgentModelConfiguration, MarAgentReasoningEffort } from '../model/configuration.js';
 import type { ModelAdapter } from '../model/contracts.js';
+import type { MarAgentSessionPage, MarAgentSessionSummary } from '../session/catalog.js';
+import type { SessionListInput, SessionSource } from '../session/jsonl-store.js';
 export type AccessMode = 'on-request' | 'full-access';
 export type ExecutionMode = 'run' | 'plan' | 'compact';
 export interface ToolCall {
@@ -83,6 +85,8 @@ export type MarAgentEvent = MarAgentEventBase & ({
     itemId: string;
     phase: 'commentary' | 'final_answer';
     text: string;
+    modelId: string;
+    modelName: string;
 } | {
     type: 'plan.completed';
     itemId: string;
@@ -117,7 +121,7 @@ export type MarAgentEvent = MarAgentEventBase & ({
     summary: string;
     truncated?: boolean;
     artifacts?: readonly MarAgentToolArtifact[];
-    data?: import('../tools/exec.js').ExecResult | Omit<import('../tools/exec.js').ExecResult, 'stdout' | 'stderr'> | import('../tools/apply-patch.js').ApplyPatchResult | import('../tools/view-image.js').ViewImageResult | import('../subagent/scheduler.js').SubagentTaskSnapshot;
+    data?: import('../tools/exec.js').ExecResult | Omit<import('../tools/exec.js').ExecResult, 'stdout' | 'stderr'> | import('../tools/apply-patch.js').ApplyPatchResult | import('../tools/read.js').ReadEventData | import('../tools/view-image.js').ViewImageResult | import('../subagent/scheduler.js').SubagentTaskSnapshot;
 } | {
     type: 'tool.failed';
     toolName: string;
@@ -146,11 +150,18 @@ export type MarAgentEvent = MarAgentEventBase & ({
     type: 'subagent.started';
     agentId: string;
     description: string;
+    modelId?: string;
+    modelName?: string;
+    reasoningEffort?: MarAgentReasoningEffort;
 } | {
     type: 'subagent.completed';
     agentId: string;
     description?: string;
     status: string;
+    modelId?: string;
+    modelName?: string;
+    reasoningEffort?: MarAgentReasoningEffort;
+    latestMessage?: import('../subagent/scheduler.js').SubagentLatestMessage;
     errorCode?: string;
     errorMessage?: string;
 } | {
@@ -212,10 +223,8 @@ export interface MarAgentSession {
 export interface MarAgent {
     createSession(input: CreateSessionInput): Promise<MarAgentSession>;
     openSession(sessionId: string): Promise<MarAgentSession>;
-    listSessions(input?: {
-        limit?: number;
-        cursor?: string;
-    }): Promise<unknown>;
+    listSessions(input?: SessionListInput): Promise<MarAgentSessionPage>;
+    clearSession(sessionId: string): Promise<void>;
     reconfigureModels(input: {
         readonly models: readonly MarAgentModelConfiguration[];
         readonly defaultModelId?: string;
@@ -244,3 +253,4 @@ export interface CreateMarAgentOptions {
     rolloutBudget?: false | RolloutBudgetOptions;
     adapterFactory?: (configuration: MarAgentModelConfiguration) => ModelAdapter;
 }
+export type { MarAgentSessionSummary, SessionListInput, SessionSource };

package/dist/sdk/types.js

@@ -1,2 +1 @@
-/* mar-release-protected */
-export{};
+export {};

package/dist/session/catalog.d.ts

@@ -1,3 +1,4 @@
+import { type SessionListInput, type SessionSource } from './jsonl-store.js';
 import type { MarAgentEvent, MarAgentImageMetadata } from '../sdk/types.js';
 export interface MarAgentSessionSummary {
     id: string;
@@ -5,6 +6,7 @@ export interface MarAgentSessionSummary {
     workspace: string;
     createdAt: string;
     lastActivityAt: string;
+    source: SessionSource;
 }
 export interface MarAgentSessionPage {
     sessions: MarAgentSessionSummary[];
@@ -22,6 +24,7 @@ export type MarAgentHistoryEntry = {
     turnId: string;
     text: string;
     clientMessageId?: string;
+    inputSource?: 'user' | 'parent_agent';
     images?: readonly MarAgentHistoryImageMetadata[];
 } | {
     kind: 'event';
@@ -46,10 +49,7 @@ export interface MarAgentSessionImage {
 }
 /** Public session catalog facade. Storage details remain SDK-private. */
 export interface MarAgentSessionCatalog {
-    list(input?: {
-        limit?: number;
-        cursor?: string;
-    }): Promise<MarAgentSessionPage>;
+    list(input?: SessionListInput): Promise<MarAgentSessionPage>;
     history(sessionId: string, input?: {
         limit?: number;
         cursor?: string;
@@ -66,6 +66,7 @@ export interface MarAgentSessionCatalog {
     rollback(sessionId: string, input: {
         readonly boundaryTurnId: string | null;
     }): Promise<MarAgentSessionSummary>;
+    clear(sessionId: string): Promise<MarAgentSessionSummary>;
     delete(sessionId: string): Promise<MarAgentSessionDeleteResult>;
     close(): Promise<void>;
 }

package/dist/session/catalog.js

@@ -1,2 +1,133 @@
-/* mar-release-protected */
-const _0x65f843=_0x2765;(function(_0x1a46fd,_0x55cabd){const _0x1e9968=_0x2765,_0x30c05a=_0x1a46fd();while(!![]){try{const _0x14257a=parseInt(_0x1e9968(0x12b))/(0x225+0x515+-0x739)*(-parseInt(_0x1e9968(0x135))/(0xc80+0x419*-0x9+0x1863*0x1))+parseInt(_0x1e9968(0x11f))/(0x1364*-0x2+-0x305*0x1+-0x1be*-0x18)+parseInt(_0x1e9968(0x140))/(0x243*0x6+0x239b*-0x1+0x160d)+parseInt(_0x1e9968(0x117))/(0x99*0x2e+-0x2694*-0x1+-0x420d)*(parseInt(_0x1e9968(0x138))/(-0x20a3+-0x2*-0xce5+0x6df*0x1))+parseInt(_0x1e9968(0x10b))/(-0x13b3+0x1*-0x2397+0x3751)*(parseInt(_0x1e9968(0x10f))/(0x249b+0xb2b+-0x2fbe))+-parseInt(_0x1e9968(0x11d))/(0xd1d+-0x16f+-0xba5)*(parseInt(_0x1e9968(0x143))/(-0x1bee+0xefe+-0x67d*-0x2))+-parseInt(_0x1e9968(0x11e))/(-0x15c+0x13d7+-0x1270);if(_0x14257a===_0x55cabd)break;else _0x30c05a['push'](_0x30c05a['shift']());}catch(_0x4c9311){_0x30c05a['push'](_0x30c05a['shift']());}}}(_0x3189,0x1*0x1bedd+0x49319+-0x3c9f5));import{JsonlSessionStore}from'./jsonl-store.js';function _0x2765(_0x17a33f,_0x2e8ffd){_0x17a33f=_0x17a33f-(-0x6*-0x114+0x11a5+-0x101*0x17);const _0x6fd9ea=_0x3189();let _0x211e4c=_0x6fd9ea[_0x17a33f];if(_0x2765['XQmArt']===undefined){var _0x3d4c07=function(_0x57a0cc){const _0x27d019='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x2ff906='',_0x39c1c1='';for(let _0x11552d=-0x690+0xcfc+-0x66c,_0x114979,_0x336631,_0x5306f8=0xe3*0x29+-0x1*0x22c2+-0x199;_0x336631=_0x57a0cc['charAt'](_0x5306f8++);~_0x336631&&(_0x114979=_0x11552d%(0x18*0x1+0x2*-0x1114+0x885*0x4)?_0x114979*(-0x1*-0x212e+-0x702+0xcf6*-0x2)+_0x336631:_0x336631,_0x11552d++%(-0x5*-0x288+0x5d*-0x6b+0x1a3b))?_0x2ff906+=String['fromCharCode'](0x7*-0x1c9+0x79c*0x3+-0x956&_0x114979>>(-(0xf75+0x3bb*-0x4+-0x1*0x87)*_0x11552d&-0xb0+0x1204+-0x114e)):-0x2382+-0x2014+-0x52*-0xd3){_0x336631=_0x27d019['indexOf'](_0x336631);}for(let _0x47ddd3=0x2*-0x102f+0x506+0x1b58,_0x414678=_0x2ff906['length'];_0x47ddd3<_0x414678;_0x47ddd3++){_0x39c1c1+='%'+('00'+_0x2ff906['charCodeAt'](_0x47ddd3)['toString'](0x17d+0x1fa*-0x4+0x15*0x4f))['slice'](-(0x1ace+-0x2*0xd8d+0x4e));}return decodeURIComponent(_0x39c1c1);};_0x2765['ygmdVy']=_0x3d4c07,_0x2765['lkZqTn']={},_0x2765['XQmArt']=!![];}const _0x4f00b1=_0x6fd9ea[-0x1475+-0x13d*-0x1d+-0x56*0x2e];_0x2765['zLVfUW']!==_0x4f00b1&&(_0x2765['lkZqTn']={},_0x2765['zLVfUW']=_0x4f00b1);const _0x516ee6=_0x2765['lkZqTn'][_0x17a33f];return _0x516ee6===undefined?(_0x211e4c=_0x2765['ygmdVy'](_0x211e4c),_0x2765['lkZqTn'][_0x17a33f]=_0x211e4c):_0x211e4c=_0x516ee6,_0x211e4c;}function _0x3189(){const _0x1e6a4b=['AxnbCNjHEq','y2XPzw50twvZC2fNzuLK','BNvTyMvY','zgf0yujHC2u2na','nZmZodbAB1jLru0','Cgf5Bg9Hza','Aw1Hz2uVANbLzW','BwLTzvr5Cgu','C3rYAw5N','Aw5WDxruB2TLBNm','nZa0nJfcAvj6CKq','ntuZntG0ouLfugTkzG','mJG0mdG4rgvLywHZ','zM9YA1nLC3nPB24','CM9SBgjHy2TtzxnZAw9U','CMvHzeLUChv0sw1Hz2u','B3bLBG','y29UDgv4Dc5JB21Wywn0zwq','y3vYC29Y','C2vXDwvUy2u','Aw1Hz2uVD2vICa','BgvUz3rO','Ag9TzurPCMvJDg9YEq','zxzLBNrjza','mJHyt0TIC1i','zxzLBNq','C2vZC2LVBKLK','AgfZ','B2jQzwn0','y2XVC2u','Dg9szxzLCNnLza','zMXHDe1HCa','ChjVBxb0','Aw1Hz2uVCg5N','nZi0mMnJy3H2qW','BgLZDa','Aw1Hz2vZ','otzeq1jlEwq','zMLSzu5HBwu','Aw1Hz2uVz2LM','DhvYBI51C2vY','BgLTAxq','DxnLCG','AxntywzLsw50zwDLCG','DgvZDa','odCXnJeYzgf1sKnO','yNL0zvnPEMu','DhvYBKLK','nZbtqM5VB0u','C2HHmJu2','y29UDgv4DeLUChv0vg9Rzw5Z','CMvJB3jKCW','ChjLDMLVDxnczwzVCMvtzxf1zw5Jzq','DhLWzq','mJHArLvYAhC','DgLTzxn0yw1W','zgvSzxrL','DxnHz2uUDxbKyxrLza','ntu1odq4qvLRzurm','CMvHzfbHz2u','zxHLy3v0Aw9Uswq','BMfTzq'];_0x3189=function(){return _0x1e6a4b;};return _0x3189();}const MAX_INPUT_IMAGE_BYTES=(-0xb4f*0x1+0x83*-0x30+-0x1*-0x23e4)*(-0x1650+0x18*0x1+0x2*0xd1c)*(-0x2*-0x457+-0x1*-0x1c96+-0x2144),INPUT_IMAGE_MIME_TYPES=new Set([_0x65f843(0x134),_0x65f843(0x119),_0x65f843(0x13a),_0x65f843(0x127)]);export async function openMarAgentSessionCatalog(_0x82ec60){const _0x286e9c=_0x65f843,_0x35d14f=await JsonlSessionStore[_0x286e9c(0x123)](_0x82ec60[_0x286e9c(0x129)]);return{'list':_0x4ea044=>_0x35d14f[_0x286e9c(0x136)](_0x4ea044),'history':async(_0x375ef9,_0xad3ccc={})=>{const _0x54a342=_0x286e9c,_0x151252=parseCursor(_0xad3ccc[_0x54a342(0x125)]),_0x318108=await _0x35d14f[_0x54a342(0x110)](_0x375ef9,{..._0xad3ccc[_0x54a342(0x13c)]===undefined?{}:{'limit':_0xad3ccc[_0x54a342(0x13c)]},..._0x151252===undefined?{}:{'beforeSequence':_0x151252}}),_0x2609a4=_0x318108[_0x54a342(0x108)][_0x54a342(0x132)](_0x277fc6=>{const _0x141534=_0x54a342;if(_0x277fc6[_0x141534(0x10a)]===_0x141534(0x13b)&&_0x277fc6[_0x141534(0x111)]!==undefined&&_0x277fc6[_0x141534(0x142)]!==undefined&&isRecord(_0x277fc6[_0x141534(0x118)])&&typeof _0x277fc6[_0x141534(0x118)][_0x141534(0x133)]===_0x141534(0x11b)){const _0x30c222=imageMetadata(_0x277fc6[_0x141534(0x118)][_0x141534(0x137)]);return[{'kind':_0x141534(0x13d),'sequence':_0x277fc6[_0x141534(0x126)],'timestamp':_0x277fc6[_0x141534(0x10c)],'sessionId':_0x277fc6[_0x141534(0x12d)],'executionId':_0x277fc6[_0x141534(0x111)],'turnId':_0x277fc6[_0x141534(0x142)],'text':_0x277fc6[_0x141534(0x118)][_0x141534(0x133)],...typeof _0x277fc6[_0x141534(0x118)][_0x141534(0x114)]===_0x141534(0x11b)?{'clientMessageId':_0x277fc6[_0x141534(0x118)][_0x141534(0x114)]}:{},..._0x30c222[_0x141534(0x128)]>-0x2556*-0x1+-0x1*-0x24f7+0x17*-0x33b?{'images':_0x30c222}:{}}];}if(isMarAgentEvent(_0x277fc6[_0x141534(0x118)]))return[{'kind':_0x141534(0x12c),'sequence':_0x277fc6[_0x141534(0x126)],'event':_0x277fc6[_0x141534(0x118)]}];return[];});return{'entries':_0x2609a4,..._0x318108[_0x54a342(0x109)]===undefined?{}:{'nextCursor':String(_0x318108[_0x54a342(0x109)])}};},'readImage':async(_0x5773c1,_0x522452)=>{const _0x3d7107=_0x286e9c,_0x41b74a=await _0x35d14f[_0x3d7107(0x122)](_0x5773c1,_0x522452);return _0x41b74a===undefined?undefined:{'name':_0x41b74a[_0x3d7107(0x112)],'mimeType':_0x41b74a[_0x3d7107(0x11a)],'byteSize':_0x41b74a[_0x3d7107(0x141)],'dataBase64':_0x41b74a[_0x3d7107(0x116)]};},'contextUsage':async _0x5067e8=>{const _0x39b4c0=_0x286e9c,_0xe9c702=await _0x35d14f[_0x39b4c0(0x110)](_0x5067e8,{'limit':0x3e8});for(const _0x11c663 of _0xe9c702[_0x39b4c0(0x108)][_0x39b4c0(0x131)]()){if(!isMarAgentEvent(_0x11c663[_0x39b4c0(0x118)]))continue;if(_0x11c663[_0x39b4c0(0x118)][_0x39b4c0(0x10a)]===_0x39b4c0(0x124))return{'inputTokens':0x0};if(_0x11c663[_0x39b4c0(0x118)][_0x39b4c0(0x10a)]===_0x39b4c0(0x10e)){const _0x367966=_0x11c663[_0x39b4c0(0x118)][_0x39b4c0(0x107)]??_0x11c663[_0x39b4c0(0x118)][_0x39b4c0(0x11c)];if(typeof _0x367966===_0x39b4c0(0x115)&&Number[_0x39b4c0(0x13e)](_0x367966)&&_0x367966>=0x58e*-0x3+0x1c9*-0x7+-0x1d29*-0x1)return{'inputTokens':_0x367966};}}return undefined;},'fork':(_0x1d6d27,_0x131324)=>_0x35d14f[_0x286e9c(0x120)](_0x1d6d27,_0x131324),'rollback':(_0x16b830,_0x5b8504)=>_0x35d14f[_0x286e9c(0x121)](_0x16b830,_0x5b8504),'delete':_0x101508=>_0x35d14f[_0x286e9c(0x10d)](_0x101508),'close':()=>_0x35d14f[_0x286e9c(0x130)]()};}function parseCursor(_0x410359){const _0x2235bb=_0x65f843;if(_0x410359===undefined)return undefined;const _0x142619=Number(_0x410359);if(!Number[_0x2235bb(0x13e)](_0x142619)||_0x142619<0xf75+0x3bb*-0x4+-0x1*0x88)return undefined;return _0x142619;}function isRecord(_0x515f5a){const _0x56b1cf=_0x65f843;return _0x515f5a!==null&&typeof _0x515f5a===_0x56b1cf(0x12f)&&!Array[_0x56b1cf(0x113)](_0x515f5a);}function imageMetadata(_0x14bafd){const _0x4f945a=_0x65f843;if(!Array[_0x4f945a(0x113)](_0x14bafd))return[];return _0x14bafd[_0x4f945a(0x132)](_0x17a33f=>isRecord(_0x17a33f)&&typeof _0x17a33f[_0x4f945a(0x112)]===_0x4f945a(0x11b)&&typeof _0x17a33f[_0x4f945a(0x11a)]===_0x4f945a(0x11b)&&typeof _0x17a33f[_0x4f945a(0x141)]===_0x4f945a(0x115)&&Number[_0x4f945a(0x13e)](_0x17a33f[_0x4f945a(0x141)])&&_0x17a33f[_0x4f945a(0x141)]>=-0xb0+0x1204+-0x1154?[{'name':_0x17a33f[_0x4f945a(0x112)],'mimeType':_0x17a33f[_0x4f945a(0x11a)],'byteSize':_0x17a33f[_0x4f945a(0x141)],'readable':INPUT_IMAGE_MIME_TYPES[_0x4f945a(0x12e)](_0x17a33f[_0x4f945a(0x11a)])&&_0x17a33f[_0x4f945a(0x141)]>-0x2382+-0x2014+-0x52*-0xd3&&_0x17a33f[_0x4f945a(0x141)]<=MAX_INPUT_IMAGE_BYTES&&typeof _0x17a33f[_0x4f945a(0x139)]===_0x4f945a(0x11b)&&/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.bin$/u[_0x4f945a(0x13f)](_0x17a33f[_0x4f945a(0x139)])&&typeof _0x17a33f[_0x4f945a(0x106)]===_0x4f945a(0x11b)&&/^[a-f0-9]{64}$/u[_0x4f945a(0x13f)](_0x17a33f[_0x4f945a(0x106)])}]:[]);}function isMarAgentEvent(_0x2e8ffd){const _0x1ad8cb=_0x65f843;return isRecord(_0x2e8ffd)&&typeof _0x2e8ffd[_0x1ad8cb(0x10a)]===_0x1ad8cb(0x11b)&&typeof _0x2e8ffd[_0x1ad8cb(0x12a)]===_0x1ad8cb(0x11b)&&typeof _0x2e8ffd[_0x1ad8cb(0x126)]===_0x1ad8cb(0x115)&&typeof _0x2e8ffd[_0x1ad8cb(0x10c)]===_0x1ad8cb(0x11b)&&typeof _0x2e8ffd[_0x1ad8cb(0x12d)]===_0x1ad8cb(0x11b)&&typeof _0x2e8ffd[_0x1ad8cb(0x111)]===_0x1ad8cb(0x11b);}
+import { JsonlSessionStore } from './jsonl-store.js';
+const MAX_INPUT_IMAGE_BYTES = 5 * 1024 * 1024;
+const INPUT_IMAGE_MIME_TYPES = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
+export async function openMarAgentSessionCatalog(input) {
+    const store = await JsonlSessionStore.open(input.homeDirectory);
+    return {
+        list: (options) => store.list(options),
+        history: async (sessionId, options = {}) => {
+            const beforeSequence = parseCursor(options.cursor);
+            const page = await store.readPage(sessionId, {
+                ...(options.limit === undefined ? {} : { limit: options.limit }),
+                ...(beforeSequence === undefined ? {} : { beforeSequence })
+            });
+            const entries = page.records.flatMap((record) => {
+                if (record.type === 'turn.user' &&
+                    record.executionId !== undefined &&
+                    record.turnId !== undefined &&
+                    isRecord(record.payload) &&
+                    typeof record.payload.prompt === 'string') {
+                    const images = imageMetadata(record.payload.images);
+                    return [
+                        {
+                            kind: 'user',
+                            sequence: record.sequence,
+                            timestamp: record.timestamp,
+                            sessionId: record.sessionId,
+                            executionId: record.executionId,
+                            turnId: record.turnId,
+                            text: record.payload.prompt,
+                            ...(typeof record.payload.clientMessageId === 'string'
+                                ? { clientMessageId: record.payload.clientMessageId }
+                                : {}),
+                            ...(record.payload.inputSource === 'parent_agent'
+                                ? { inputSource: 'parent_agent' }
+                                : {}),
+                            ...(images.length > 0 ? { images } : {})
+                        }
+                    ];
+                }
+                if (isMarAgentEvent(record.payload))
+                    return [{ kind: 'event', sequence: record.sequence, event: record.payload }];
+                return [];
+            });
+            return {
+                entries,
+                ...(page.previousBeforeSequence === undefined
+                    ? {}
+                    : { nextCursor: String(page.previousBeforeSequence) })
+            };
+        },
+        readImage: async (sessionId, input) => {
+            const image = await store.readInputImage(sessionId, input);
+            return image === undefined
+                ? undefined
+                : {
+                    name: image.name,
+                    mimeType: image.mimeType,
+                    byteSize: image.byteSize,
+                    dataBase64: image.dataBase64
+                };
+        },
+        contextUsage: async (sessionId) => {
+            const page = await store.readPage(sessionId, { limit: 1000 });
+            for (const record of page.records.toReversed()) {
+                if (!isMarAgentEvent(record.payload))
+                    continue;
+                if (record.payload.type === 'context.compacted')
+                    return { inputTokens: 0 };
+                if (record.payload.type === 'usage.updated') {
+                    const inputTokens = record.payload.contextInputTokens ?? record.payload.inputTokens;
+                    if (typeof inputTokens === 'number' &&
+                        Number.isSafeInteger(inputTokens) &&
+                        inputTokens >= 0)
+                        return { inputTokens };
+                }
+            }
+            return undefined;
+        },
+        fork: async (sessionId, options) => {
+            const session = await store.forkSession(sessionId, options);
+            return { ...session, source: session.source ?? { type: 'user' } };
+        },
+        rollback: (sessionId, options) => store.rollbackSession(sessionId, options),
+        clear: (sessionId) => store.clearSession(sessionId),
+        delete: (sessionId) => store.delete(sessionId),
+        close: () => store.close()
+    };
+}
+function parseCursor(cursor) {
+    if (cursor === undefined)
+        return undefined;
+    const value = Number(cursor);
+    if (!Number.isSafeInteger(value) || value < 1)
+        return undefined;
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function imageMetadata(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((image) => isRecord(image) &&
+        typeof image.name === 'string' &&
+        typeof image.mimeType === 'string' &&
+        typeof image.byteSize === 'number' &&
+        Number.isSafeInteger(image.byteSize) &&
+        image.byteSize >= 0
+        ? [
+            {
+                name: image.name,
+                mimeType: image.mimeType,
+                byteSize: image.byteSize,
+                readable: INPUT_IMAGE_MIME_TYPES.has(image.mimeType) &&
+                    image.byteSize > 0 &&
+                    image.byteSize <= MAX_INPUT_IMAGE_BYTES &&
+                    typeof image.fileName === 'string' &&
+                    /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.bin$/u.test(image.fileName) &&
+                    typeof image.sha256 === 'string' &&
+                    /^[a-f0-9]{64}$/u.test(image.sha256)
+            }
+        ]
+        : []);
+}
+function isMarAgentEvent(value) {
+    return (isRecord(value) &&
+        typeof value.type === 'string' &&
+        typeof value.eventId === 'string' &&
+        typeof value.sequence === 'number' &&
+        typeof value.timestamp === 'string' &&
+        typeof value.sessionId === 'string' &&
+        typeof value.executionId === 'string');
+}

package/dist/session/context-gc-checkpoint.d.ts

@@ -0,0 +1,148 @@
+import { type ContextGcSubagentToolName } from './context-gc-subagent.js';
+import type { SessionRecord } from './jsonl-store.js';
+export declare const CONTEXT_GC_CHECKPOINT_VERSION: 1;
+export declare const CONTEXT_GC_MAX_TARGETS = 4096;
+export type ContextGcPlatform = 'linux' | 'darwin' | 'win32';
+export interface ContextGcEconomicsPolicy {
+    readonly version: 1;
+    readonly immediatePaybackRollouts: number;
+    readonly maximumPaybackRollouts: number;
+    readonly contextGrowthSampleWindow: number;
+    readonly minimumContextGrowthSamples: number;
+    readonly minimumObservationRollouts: number;
+    readonly stageAProtectionRollouts: number;
+    readonly largeExecProtectionRollouts: number;
+    readonly normalInputCostRate: number;
+    readonly cacheReadCostRate: number;
+    readonly cacheWriteCostRate: number;
+    readonly outputCostRate: number;
+    readonly minimumGrossReductionRate: number;
+    readonly minimumCacheInvestmentRoi: number;
+}
+export type ContextGcBase = {
+    readonly type: 'SESSION_START';
+    readonly firstSequence: number;
+} | {
+    readonly type: 'COMPACT';
+    readonly sequence: number;
+    readonly recordId: string;
+};
+export interface ContextGcTarget {
+    readonly sequence: number;
+    readonly recordId: string;
+    readonly role: 'tool_call' | 'tool' | 'provider';
+    readonly callId?: string;
+    readonly toolName?: string;
+    readonly sourceHash: string;
+}
+export interface ContextGcReadItemReplacement {
+    readonly index: number;
+    readonly path: string;
+    readonly replacement: string;
+    readonly evidenceSequence: number;
+}
+export type ContextGcReplacement = {
+    readonly kind: 'READ_OUTPUT_ITEMS';
+    readonly callId: string;
+    readonly target: ContextGcTarget;
+    readonly items: readonly ContextGcReadItemReplacement[];
+    readonly evidenceSequences: readonly number[];
+} | {
+    readonly kind: 'TOOL_CALL_INPUT';
+    readonly toolName: 'apply_patch' | 'exec';
+    readonly callId: string;
+    readonly target: ContextGcTarget;
+    readonly replacementArguments: unknown;
+    readonly providerAliasTargets: readonly ContextGcTarget[];
+    readonly evidenceSequence: number;
+} | {
+    readonly kind: 'EXEC_OUTPUT';
+    readonly callId: string;
+    readonly target: ContextGcTarget;
+    readonly replacementContent: string;
+    readonly evidenceSequence: number;
+} | {
+    readonly kind: 'SUBAGENT_OUTPUT';
+    readonly toolName: 'agent_wait' | 'agent_message';
+    readonly callId: string;
+    readonly target: ContextGcTarget;
+    readonly replacementContent: string;
+    readonly terminalToolName: ContextGcSubagentToolName;
+    readonly terminalCallId: string;
+    readonly evidenceSequence: number;
+    readonly retainedPriorFinal?: {
+        readonly toolName: ContextGcSubagentToolName;
+        readonly callId: string;
+        readonly evidenceSequence: number;
+    };
+};
+export interface ContextGcMetrics {
+    readonly stage: 'STAGE_A' | 'STAGE_A_AND_EXEC';
+    readonly tokenEstimator?: 'UTF8_BYTES_V1';
+    readonly beforeTokens: number;
+    readonly afterTokens: number;
+    readonly reclaimedTokens: number;
+    readonly grossReductionRate: number;
+    readonly effectiveMinimumGrossReductionRate?: number;
+    readonly minimumRequiredReclaimedTokens?: number;
+    readonly cacheRebuildPenaltyCostUnits: number;
+    readonly compactDeferralCreditCostUnits: number;
+    readonly imminentCompactAvoidanceCreditCostUnits?: number;
+    readonly appliedCompactCreditCostUnits?: number;
+    readonly requiredPositiveNetRollouts: number;
+    readonly requiredTargetRoiRollouts: number;
+    readonly projectedRolloutsUntilCompactAfterGc: number;
+    readonly projectedTokensBeforeGc?: number;
+    readonly projectedTokensAfterGc?: number;
+    readonly contextGrowthSampleCount: number;
+    readonly contextGrowthP75Tokens: number;
+    readonly expectedNetSavedCostUnits: number;
+    readonly cacheInvestmentRoi: number;
+    readonly minimumObservedRollouts: number;
+    readonly protectedCandidateTokens: number;
+    readonly eligibleCandidateCount: number;
+    readonly eligibleTargetCount: number;
+    readonly cachePenaltyKnown?: boolean;
+}
+export interface ContextGcCheckpointDraft {
+    readonly version: 1;
+    readonly base: ContextGcBase;
+    readonly boundarySequence: number;
+    sourceProjectionHash: string;
+    readonly replacements: readonly ContextGcReplacement[];
+    readonly trigger: {
+        readonly usageSequence: number;
+        readonly contextInputTokens: number;
+        readonly contextWindowTokens: number;
+        readonly normalRolloutOrdinal: number;
+        readonly modelId: string;
+        readonly platform: ContextGcPlatform;
+    };
+    readonly economics: ContextGcEconomicsPolicy;
+    readonly metrics: ContextGcMetrics;
+}
+export interface ContextGcCheckpointPayload extends ContextGcCheckpointDraft {
+    readonly checkpointId: string;
+    readonly generation: number;
+}
+/** Disposable memoization for one evaluation's immutable record snapshot. */
+export declare class ContextGcCheckpointCache {
+    #private;
+    read(records: readonly SessionRecord[], boundarySequence?: number, workspace?: string | undefined): ReturnType<typeof latestValidContextGcCheckpoint>;
+}
+export declare function contextGcMinimumUsageGrowth(contextWindowTokens: number): number;
+export declare function contextGcRecordSourceHash(record: Pick<SessionRecord, 'payload'>): string;
+export declare function contextGcLogicalPathKey(path: string, workspace: string, platform?: ContextGcPlatform): string | undefined;
+export declare function contextGcTargetKey(target: ContextGcTarget): string;
+export declare function contextGcReplacementKey(replacement: ContextGcReplacement): string;
+export declare function contextGcBaseFromRecords(records: readonly SessionRecord[], boundarySequence?: number): ContextGcBase | undefined;
+export declare function contextGcBaseSequence(base: ContextGcBase): number;
+export declare function contextGcSourceProjectionHash(records: readonly SessionRecord[], boundarySequence: number, base?: ContextGcBase | undefined): string | undefined;
+export declare function normalizeContextGcReplacements(replacements: readonly ContextGcReplacement[]): ContextGcReplacement[] | undefined;
+export declare function parseContextGcCheckpoint(record: SessionRecord | undefined): ContextGcCheckpointPayload | undefined;
+export declare function validateContextGcCheckpoint(records: readonly SessionRecord[], record: SessionRecord, workspace?: string | undefined): ContextGcCheckpointPayload | undefined;
+export declare function latestValidContextGcCheckpoint(records: readonly SessionRecord[], boundarySequence?: number, workspace?: string | undefined): {
+    readonly record: SessionRecord;
+    readonly payload: ContextGcCheckpointPayload;
+} | undefined;
+export declare function sameContextGcBase(left: ContextGcBase | undefined, right: ContextGcBase | undefined): boolean;