@geminixiang/mikan 1.0.0-beta.5 → 1.0.0-beta.51

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

@@ -1,77 +1,40 @@
-import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import type { AgentMessage, Entry } from "@earendil-works/pi-agent-core";
 import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
-import { type SessionContext, type SessionEntry, type SessionFileEntry, type SessionHeader } from "./types.js";
-/** Parse JSONL content tolerantly: malformed lines are skipped. */
-export declare function parseSessionFileEntries(content: string): SessionFileEntry[];
-/**
- * Load a session file. Returns no entries when the file is missing or its
- * first parseable line is not a valid session header (mirrors the tolerant
- * read behavior mikan has relied on). Throws only on I/O errors.
- */
-export declare function loadSessionFileEntries(filePath: string): SessionFileEntry[];
-/**
- * Append-oriented session store over one v3 JSONL file.
- *
- * Reading is tolerant (missing files and malformed lines yield an empty
- * session); appends persist immediately. A session opened from a file
- * without a valid header gets its header materialized on the first append.
- */
-export declare class SessionStore {
+import type { SessionContext, SessionCreateInfo, SessionHeader, SessionInspection } from "./types.js";
+export declare class SessionStore implements SessionInspection {
     private readonly sessionFile;
     private readonly cwd;
-    private readonly sessionId;
-    private header;
-    private headerOnDisk;
-    private entries;
-    private byId;
-    private leafId;
+    private state;
+    private writerKey;
+    private mutationTail;
+    private closePromise;
+    private closed;
     private constructor();
-    /**
-     * Open a session file. A missing or empty file starts an empty session
-     * whose header is written on the first append. A file that has content but
-     * no leading session header is treated as corrupted and throws, rather than
-     * being silently overwritten on the next append (which would erase the
-     * existing history). Callers on read paths already wrap this in try/catch.
-     * @param cwdOverride Working directory override; defaults to the header cwd.
-     */
-    static open(path: string, cwdOverride?: string): SessionStore;
-    /** Create a new session file with a fresh header, replacing any existing file. */
-    static create(path: string, cwd: string, options?: {
-        id?: string;
-    }): SessionStore;
-    getSessionFile(): string;
+    static open(path: string, cwdOverride?: string): Promise<SessionStore>;
+    static inspect(path: string): Promise<SessionInspection>;
+    static create(path: string, cwd: string, options?: SessionCreateInfo): Promise<SessionStore>;
+    static readHeader(path: string): SessionHeader | null;
+    static writeHeaderFile(path: string, cwd: string, options?: SessionCreateInfo): void;
+    static inMemory(cwd?: string): SessionStore;
+    getSessionFile(): string | undefined;
+    isPersisted(): boolean;
     getCwd(): string;
-    /** Session header as read from disk, or null when the file had none. */
-    getHeader(): SessionHeader | null;
-    /** Stable session id: the header id, or a generated id for fresh sessions. */
+    getHeader(): SessionHeader;
     getSessionId(): string;
-    getLeafId(): string | null;
-    getEntry(id: string): SessionEntry | undefined;
-    /** All session entries (header excluded). Returns a shallow copy. */
-    getEntries(): SessionEntry[];
-    /** Latest user-assigned session name, if any. */
-    getSessionName(): string | undefined;
-    /**
-     * Walk from an entry to the root, returning entries in path order
-     * (root first). Defaults to the current leaf.
-     */
-    getBranch(fromId?: string): SessionEntry[];
-    /**
-     * Build the LLM context (messages, thinking level, model) from the current
-     * branch, resolving compaction and branch summaries along the path.
-     */
-    buildSessionContext(): SessionContext;
-    /** Append a chat message as a child of the current leaf. Returns the entry id. */
-    appendMessage(message: AgentMessage): string;
-    /** Append an extension/application data entry (never sent to the LLM). */
-    appendCustomEntry(customType: string, data?: unknown): string;
-    /** Append a custom message entry that participates in LLM context. */
-    appendCustomMessageEntry(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details?: unknown): string;
-    /** Record a user-visible session name. */
-    appendSessionInfo(name: string): string;
-    /** Persist a compaction summary produced for this session. */
-    appendCompaction(summary: string, firstKeptEntryId: string, tokensBefore: number, details?: unknown, fromHook?: boolean): string;
-    private appendEntry;
-    private persist;
+    getLeafId(): Promise<string | null>;
+    getEntry(id: string): Promise<Entry | undefined>;
+    getEntries(): Promise<Entry[]>;
+    getSessionName(): Promise<string | undefined>;
+    getBranch(fromId?: string): Promise<Entry[]>;
+    buildSessionContext(): Promise<SessionContext>;
+    appendMessage(message: AgentMessage): Promise<string>;
+    appendCustomEntry(customType: string, data?: unknown): Promise<string>;
+    appendCustomMessageEntry(customType: string, content: string | Array<TextContent | ImageContent>, display: boolean, details?: unknown): Promise<string>;
+    setSessionName(name: string): Promise<void>;
+    appendCompaction(summary: string, retainedTail: AgentMessage[], tokensBefore: number, details?: unknown): Promise<string>;
+    close(): Promise<void>;
+    private assertOpen;
+    private mutate;
+    private live;
 }
 //# sourceMappingURL=session-store.d.ts.map

package/dist/harness/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAkBpB,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmB3E;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAM3E;AAQD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,eAiBN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAW5D;IAED,kFAAkF;IAClF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAUhF;IAED,cAAc,IAAI,MAAM,CAEvB;IAED,MAAM,IAAI,MAAM,CAEf;IAED,wEAAwE;IACxE,SAAS,IAAI,aAAa,GAAG,IAAI,CAEhC;IAED,8EAA8E;IAC9E,YAAY,IAAI,MAAM,CAErB;IAED,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7C;IAED,qEAAqE;IACrE,UAAU,IAAI,YAAY,EAAE,CAE3B;IAED,iDAAiD;IACjD,cAAc,IAAI,MAAM,GAAG,SAAS,CAMnC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAUzC;IAED;;;OAGG;IACH,mBAAmB,IAAI,cAAc,CAEpC;IAED,kFAAkF;IAClF,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE3C;IAED,0EAA0E;IAC1E,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5D;IAED,sEAAsE;IACtE,wBAAwB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAER;IAED,0CAA0C;IAC1C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtC;IAED,8DAA8D;IAC9D,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CASR;IAED,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,OAAO;CAiBhB"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"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"}