@myagentroam/agent 0.11.73 → 0.12.0

package/dist/session/catalog.d.ts

@@ -37,6 +37,8 @@ export interface AgentSessionImage {
 /** Public session catalog facade. Storage details remain SDK-private. */
 export interface AgentSessionCatalog {
     list(input?: SessionListInput): Promise<AgentSessionPage>;
+    /** Complete, detached metadata from one directory read; unordered and without history reads. */
+    listSnapshot(): Promise<AgentSessionSummary[]>;
     firstUserMessagePreview(sessionId: string): Promise<string | undefined>;
     executionConfiguration(sessionId: string): Promise<{
         readonly modelId: string;
@@ -86,5 +88,5 @@ export type OpenAgentSessionCatalogInput = {
     sessionStore: SessionStore;
     homeDirectory?: never;
 };
-export declare function createSessionCatalog(store: Pick<SessionStore, 'list' | 'firstUserMessagePreview' | 'executionConfiguration' | 'readPage' | 'readInputImage' | 'readResource' | 'readToolResultResource' | 'forkSession' | 'rollbackSession' | 'clearSession' | 'delete' | 'acquireSessionMaintenance' | 'close'>, borrowed: boolean): AgentSessionCatalog;
+export declare function createSessionCatalog(store: Pick<SessionStore, 'list' | 'listSnapshot' | 'firstUserMessagePreview' | 'executionConfiguration' | 'readPage' | 'readInputImage' | 'readResource' | 'readToolResultResource' | 'forkSession' | 'rollbackSession' | 'clearSession' | 'delete' | 'acquireSessionMaintenance' | 'close'>, borrowed: boolean): AgentSessionCatalog;
 export declare function imageMetadata(value: unknown): AgentSessionHistoryImageMetadata[];

package/dist/session/catalog.js

@@ -17,6 +17,10 @@ export function createSessionCatalog(store, borrowed) {
             assertOpen();
             return store.list(options);
         },
+        listSnapshot: async () => {
+            assertOpen();
+            return store.listSnapshot();
+        },
         firstUserMessagePreview: async (sessionId) => {
             assertOpen();
             return store.firstUserMessagePreview(sessionId);

package/dist/session/store/contracts.d.ts

@@ -75,6 +75,8 @@ export interface SessionStore {
         automaticTitlePending: boolean;
     }>;
     list(input?: SessionListInput): Promise<AgentSessionPage>;
+    /** Complete, detached metadata from one directory read; unordered and without history reads. */
+    listSnapshot(): Promise<AgentSessionSummary[]>;
     listSubagentChildren(parentSessionId: string): Promise<Array<AgentSessionSummary & {
         source: Extract<SessionSource, {
             type: 'subagent';

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

@@ -119,6 +119,18 @@ export declare class JsonlSessionStore implements SessionStore {
     /** Native writes join their Agent's sole writer, without admitting another Execution. */
     acquireSessionWriteLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
     retainSessionLease(sessionId: string, owner: object): Promise<() => Promise<void>>;
+    listSnapshot(): Promise<{
+        reasoningEffort?: string;
+        modelName?: string;
+        modelId?: string;
+        workspace: string;
+        createdAt: string;
+        lastActivityAt: string;
+        source: SessionSource;
+        firstUserMessagePreview?: string;
+        id: string;
+        title: string;
+    }[]>;
     list(input?: SessionListInput): Promise<{
         nextCursor?: string;
         sessions: {

package/dist/session/store/jsonl/jsonl-store.js

@@ -1704,16 +1704,8 @@ export class JsonlSessionStore {
             throw error;
         }
     }
-    async list(input = {}) {
-        this.#assertOpen();
-        await this.#refreshIndex();
-        const filter = sessionListFilter(input);
-        const start = decodeSessionListCursor(input.cursor, this.#shared.index.revision, filter);
-        const limit = Math.min(200, Math.max(1, input.limit ?? 50));
-        const ordered = this.#shared.index.sessions
-            .filter((session) => sessionMatchesFilter(session, filter))
-            .sort((a, b) => b.lastActivityAt.localeCompare(a.lastActivityAt));
-        const sessions = ordered.slice(start, start + limit).map((session) => ({
+    #sessionSummary(session) {
+        return {
             id: session.id,
             title: session.title,
             ...(session.resume?.firstUserMessagePreview === undefined
@@ -1722,7 +1714,7 @@ export class JsonlSessionStore {
             workspace: session.workspace,
             createdAt: session.createdAt,
             lastActivityAt: session.lastActivityAt,
-            source: normalizeSessionSource(session.source),
+            source: structuredClone(normalizeSessionSource(session.source)),
             ...(session.resume?.modelId === undefined
                 ? {}
                 : {
@@ -1734,7 +1726,25 @@ export class JsonlSessionStore {
                         ? {}
                         : { reasoningEffort: session.resume.reasoningEffort })
                 })
-        }));
+        };
+    }
+    async listSnapshot() {
+        this.#assertOpen();
+        await this.#refreshIndex();
+        return this.#shared.index.sessions.map((session) => this.#sessionSummary(session));
+    }
+    async list(input = {}) {
+        this.#assertOpen();
+        await this.#refreshIndex();
+        const filter = sessionListFilter(input);
+        const start = decodeSessionListCursor(input.cursor, this.#shared.index.revision, filter);
+        const limit = Math.min(200, Math.max(1, input.limit ?? 50));
+        const ordered = this.#shared.index.sessions
+            .filter((session) => sessionMatchesFilter(session, filter))
+            .sort((a, b) => b.lastActivityAt.localeCompare(a.lastActivityAt));
+        const sessions = ordered
+            .slice(start, start + limit)
+            .map((session) => this.#sessionSummary(session));
         const next = start + limit < ordered.length
             ? encodeSessionListCursor(this.#shared.index.revision, start + limit, filter)
             : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.11.73",
+  "version": "0.12.0",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",