@myagentroam/agent 0.9.62 → 0.9.65

package/dist/session/jsonl-store.d.ts

@@ -1,5 +1,7 @@
+import type { ModelUsage } from '../model/contracts.js';
 import type { EnvironmentContextState } from '../prompts/core.js';
 import { type TodoSnapshot } from '../tools/todo.js';
+import { type ContextGcCheckpointDraft } from './context-gc-checkpoint.js';
 export interface SessionRecord {
     schemaVersion: 1;
     recordId: string;
@@ -16,6 +18,23 @@ export interface SessionExecutionState {
     todo: TodoSnapshot;
     contextRecords: SessionRecord[];
 }
+export type SessionSource = {
+    readonly type: 'user';
+} | {
+    readonly type: 'subagent';
+    readonly parentSessionId: string;
+    readonly rootSessionId: string;
+    readonly parentExecutionId: string;
+    readonly role: 'general-purpose' | 'explore';
+    readonly description: string;
+};
+export interface SessionListInput {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly source?: SessionSource['type'];
+    readonly parentSessionId?: string;
+    readonly rootSessionId?: string;
+}
 export interface CompactHistoryMessage {
     role: 'user';
     content: string;
@@ -46,11 +65,15 @@ interface SessionMeta {
     workspace: string;
     createdAt: string;
     lastActivityAt: string;
+    source?: SessionSource;
     nextSequence: number;
     automaticTitlePending?: boolean;
     resume?: {
         version: 1;
         compactSequence?: number;
+        gcSequence?: number;
+        gcGeneration?: number;
+        gcBaseSequence?: number;
         todoSequence?: number;
         todoRevision: number;
     };
@@ -68,6 +91,7 @@ export declare class JsonlSessionStore {
     createSession(input: {
         title?: string;
         workspace: string;
+        source?: SessionSource;
     }): Promise<SessionMeta>;
     sessionDirectory(sessionId: string): string;
     persistInputImages(sessionId: string, images: readonly SessionInputImage[]): Promise<SessionInputImageMetadata[]>;
@@ -86,6 +110,7 @@ export declare class JsonlSessionStore {
         workspace: string;
         createdAt: string;
         lastActivityAt: string;
+        source: SessionSource | undefined;
     }>;
     rollbackSession(sessionId: string, input: {
         readonly boundaryTurnId: string | null;
@@ -95,17 +120,27 @@ export declare class JsonlSessionStore {
         workspace: string;
         createdAt: string;
         lastActivityAt: string;
+        source: SessionSource;
     }>;
     updateTitle(sessionId: string, title: string, input?: {
         executionId?: string;
         turnId?: string;
     }): Promise<void>;
+    clearSession(sessionId: string): Promise<{
+        id: string;
+        title: string;
+        workspace: string;
+        createdAt: string;
+        lastActivityAt: string;
+        source: SessionSource;
+    }>;
     getSession(sessionId: string): Promise<{
         id: string;
         title: string;
         workspace: string;
         createdAt: string;
         lastActivityAt: string;
+        source: SessionSource;
     }>;
     append(sessionId: string, input: {
         type: string;
@@ -117,6 +152,8 @@ export declare class JsonlSessionStore {
     read(sessionId: string): Promise<SessionRecord[]>;
     readExecutionState(sessionId: string): Promise<SessionExecutionState>;
     readContext(sessionId: string): Promise<SessionRecord[]>;
+    contextGcProjectionHash(sessionId: string, boundarySequence: number): Promise<string>;
+    commitContextGc(sessionId: string, draft: ContextGcCheckpointDraft): Promise<SessionRecord>;
     readPage(sessionId: string, input?: {
         limit?: number;
         beforeSequence?: number;
@@ -130,14 +167,13 @@ export declare class JsonlSessionStore {
         environment?: EnvironmentContextState;
         automatic?: boolean;
         modelId?: string;
+        contextWindowTokens?: number;
+        usage?: ModelUsage;
         executionId?: string;
         turnId?: string;
     }): Promise<SessionRecord>;
     acquireSessionLease(sessionId: string): Promise<() => Promise<void>>;
-    list(input?: {
-        limit?: number;
-        cursor?: string;
-    }): Promise<{
+    list(input?: SessionListInput): Promise<{
         nextCursor?: string;
         sessions: {
             id: string;
@@ -145,8 +181,10 @@ export declare class JsonlSessionStore {
             workspace: string;
             createdAt: string;
             lastActivityAt: string;
+            source: SessionSource;
         }[];
     }>;
+    sessionTree(sessionId: string): Promise<readonly string[]>;
     delete(sessionId: string): Promise<{
         readonly deleted: boolean;
     }>;