@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

package/dist/sessions/session-key.d.ts

@@ -1,32 +1,18 @@
-import type { ConversationKind } from "../types.js";
+import type { ConversationKind, OfficeAddress } from "../types.js";
 export type { ResolveSessionKeyOptions } from "./types.js";
 import type { ResolveSessionKeyOptions } from "./types.js";
-export declare function assertConversationId(conversationId: string): string;
-/** Validate the opaque scoped suffix without changing its platform value. */
+export declare function assertSessionConversationId(conversationId: string): string;
 export declare function assertSessionSuffix(suffix: string): string;
-/** Build a scoped thread session key. */
 export declare function makeThreadSessionKey(conversationId: string, suffix: string): string;
-/**
- * Validate that a platform-computed session key belongs to its conversation.
- * The key may be the bare conversation id or one of that conversation's
- * scoped keys; callers must not be able to select another conversation's
- * runtime/cache entry.
- */
 export declare function assertSessionKeyBelongsToConversation(sessionKey: string, conversationId: string): string;
-/**
- * The runtime fallback: honor a platform-computed session key, otherwise
- * scope the event to its thread (or to itself for thread-starting messages).
- */
 export declare function deriveSessionKey(event: {
+    address: OfficeAddress;
     sessionKey?: string;
-    conversationId: string;
     thread_ts?: string;
     ts: string;
 }): string;
 export declare function isThreadSessionKey(sessionKey: string): boolean;
-/** The conversation a session key belongs to (identity for bare keys). */
 export declare function conversationIdOf(sessionKey: string): string;
-/** The thread suffix of a scoped key, or null for a bare conversation key. */
 export declare function threadSuffixOf(sessionKey: string): string | null;
 export declare function resolveChatSessionKey(options: ResolveSessionKeyOptions): string;
 export declare function inferConversationKind(platform: string, conversationId: string): ConversationKind;

package/dist/sessions/session-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-key.d.ts","sourceRoot":"","sources":["../../src/sessions/session-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAuC3D,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAKT;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAgB/E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAehG"}
+{"version":3,"file":"session-key.d.ts","sourceRoot":"","sources":["../../src/sessions/session-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAyB3D,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAS1E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,qCAAqC,CACnD,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,MAAM,CAYR;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,MAAM,CAMT;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAgB/E;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAchG"}

package/dist/sessions/session-key.js

@@ -1,16 +1,3 @@
-/**
- * The session-key grammar. A session key is the conversation-scoped runtime
- * identity used to serialize and resume work (see CONTEXT.md):
- *
- *   `conversationId`            — the persistent conversation session
- *   `conversationId:suffix`     — a scoped thread session (suffix = thread
- *                                 ts / message id, opaque to this module)
- *
- * This module owns the convention; nothing else may split on ":". The grammar
- * only works because conversation ids never contain ":" — that invariant is
- * asserted here at every derivation instead of being assumed everywhere.
- */
-/** Characters that can change host path structure or make identity logs ambiguous. */
 const PATH_SEPARATOR_PATTERN = /[\\/]/;
 function containsControlCharacter(value) {
     for (const character of value) {
@@ -32,7 +19,7 @@ function assertSafeIdentityPart(value, label) {
     }
     return value;
 }
-export function assertConversationId(conversationId) {
+export function assertSessionConversationId(conversationId) {
     assertSafeIdentityPart(conversationId, "Conversation id");
     if (conversationId.includes(":")) {
         throw new Error(`Conversation id must not contain ":" (got ${JSON.stringify(conversationId)}); ` +
@@ -40,22 +27,14 @@ export function assertConversationId(conversationId) {
     }
     return conversationId;
 }
-/** Validate the opaque scoped suffix without changing its platform value. */
 export function assertSessionSuffix(suffix) {
     return assertSafeIdentityPart(suffix, "Session suffix");
 }
-/** Build a scoped thread session key. */
 export function makeThreadSessionKey(conversationId, suffix) {
-    return `${assertConversationId(conversationId)}:${assertSessionSuffix(suffix)}`;
+    return `${assertSessionConversationId(conversationId)}:${assertSessionSuffix(suffix)}`;
 }
-/**
- * Validate that a platform-computed session key belongs to its conversation.
- * The key may be the bare conversation id or one of that conversation's
- * scoped keys; callers must not be able to select another conversation's
- * runtime/cache entry.
- */
 export function assertSessionKeyBelongsToConversation(sessionKey, conversationId) {
-    const expectedConversationId = assertConversationId(conversationId);
+    const expectedConversationId = assertSessionConversationId(conversationId);
     const actualConversationId = conversationIdOf(sessionKey);
     if (actualConversationId !== expectedConversationId) {
         throw new Error(`Session key ${JSON.stringify(sessionKey)} does not belong to conversation ` +
@@ -66,25 +45,20 @@ export function assertSessionKeyBelongsToConversation(sessionKey, conversationId
         assertSessionSuffix(suffix);
     return sessionKey;
 }
-/**
- * The runtime fallback: honor a platform-computed session key, otherwise
- * scope the event to its thread (or to itself for thread-starting messages).
- */
 export function deriveSessionKey(event) {
+    const conversationId = event.address.conversationId;
     if (event.sessionKey !== undefined) {
-        return assertSessionKeyBelongsToConversation(event.sessionKey, event.conversationId);
+        return assertSessionKeyBelongsToConversation(event.sessionKey, conversationId);
     }
-    return makeThreadSessionKey(event.conversationId, event.thread_ts ?? event.ts);
+    return makeThreadSessionKey(conversationId, event.thread_ts ?? event.ts);
 }
 export function isThreadSessionKey(sessionKey) {
     return sessionKey.includes(":");
 }
-/** The conversation a session key belongs to (identity for bare keys). */
 export function conversationIdOf(sessionKey) {
     const separator = sessionKey.indexOf(":");
     return separator === -1 ? sessionKey : sessionKey.slice(0, separator);
 }
-/** The thread suffix of a scoped key, or null for a bare conversation key. */
 export function threadSuffixOf(sessionKey) {
     const separator = sessionKey.indexOf(":");
     return separator === -1 ? null : sessionKey.slice(separator + 1);
@@ -92,10 +66,10 @@ export function threadSuffixOf(sessionKey) {
 export function resolveChatSessionKey(options) {
     const { conversationId, conversationKind, messageId, persistentTopLevel, scopeDirectThreads, threadTs, } = options;
     if (conversationKind === "direct" && (!threadTs || !scopeDirectThreads)) {
-        return assertConversationId(conversationId);
+        return assertSessionConversationId(conversationId);
     }
     if (!threadTs && persistentTopLevel) {
-        return assertConversationId(conversationId);
+        return assertSessionConversationId(conversationId);
     }
     return makeThreadSessionKey(conversationId, threadTs || messageId);
 }
@@ -109,7 +83,6 @@ export function inferConversationKind(platform, conversationId) {
     if (platform === "discord") {
         return conversationId.startsWith("DM") ? "direct" : "shared";
     }
-    // github: issues/PRs are always shared within the repo; there are no DMs.
     return "shared";
 }
 //# sourceMappingURL=session-key.js.map

package/dist/sessions/session-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-key.js","sourceRoot":"","sources":["../../src/sessions/session-key.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConversationKind } from \"../types.js\";\nexport type { ResolveSessionKeyOptions } from \"./types.js\";\nimport type { ResolveSessionKeyOptions } from \"./types.js\";\n\n/**\n * The session-key grammar. A session key is the conversation-scoped runtime\n * identity used to serialize and resume work (see CONTEXT.md):\n *\n *   `conversationId`            — the persistent conversation session\n *   `conversationId:suffix`     — a scoped thread session (suffix = thread\n *                                 ts / message id, opaque to this module)\n *\n * This module owns the convention; nothing else may split on \":\". The grammar\n * only works because conversation ids never contain \":\" — that invariant is\n * asserted here at every derivation instead of being assumed everywhere.\n */\n\n/** Characters that can change host path structure or make identity logs ambiguous. */\nconst PATH_SEPARATOR_PATTERN = /[\\\\/]/;\n\nfunction containsControlCharacter(value: string): boolean {\n  for (const character of value) {\n    const codePoint = character.codePointAt(0)!;\n    if (codePoint <= 0x1f || codePoint === 0x7f) return true;\n  }\n  return false;\n}\n\nfunction assertSafeIdentityPart(value: string, label: string): string {\n  if (!value || value === \".\" || value === \"..\") {\n    throw new Error(`${label} must be a non-empty identity segment (got ${JSON.stringify(value)})`);\n  }\n  if (PATH_SEPARATOR_PATTERN.test(value)) {\n    throw new Error(`${label} must not contain path separators (got ${JSON.stringify(value)})`);\n  }\n  if (containsControlCharacter(value)) {\n    throw new Error(`${label} must not contain control characters (got ${JSON.stringify(value)})`);\n  }\n  return value;\n}\n\nexport function assertConversationId(conversationId: string): string {\n  assertSafeIdentityPart(conversationId, \"Conversation id\");\n  if (conversationId.includes(\":\")) {\n    throw new Error(\n      `Conversation id must not contain \":\" (got ${JSON.stringify(conversationId)}); ` +\n        \"the session-key grammar reserves it for thread suffixes\",\n    );\n  }\n  return conversationId;\n}\n\n/** Validate the opaque scoped suffix without changing its platform value. */\nexport function assertSessionSuffix(suffix: string): string {\n  return assertSafeIdentityPart(suffix, \"Session suffix\");\n}\n\n/** Build a scoped thread session key. */\nexport function makeThreadSessionKey(conversationId: string, suffix: string): string {\n  return `${assertConversationId(conversationId)}:${assertSessionSuffix(suffix)}`;\n}\n\n/**\n * Validate that a platform-computed session key belongs to its conversation.\n * The key may be the bare conversation id or one of that conversation's\n * scoped keys; callers must not be able to select another conversation's\n * runtime/cache entry.\n */\nexport function assertSessionKeyBelongsToConversation(\n  sessionKey: string,\n  conversationId: string,\n): string {\n  const expectedConversationId = assertConversationId(conversationId);\n  const actualConversationId = conversationIdOf(sessionKey);\n  if (actualConversationId !== expectedConversationId) {\n    throw new Error(\n      `Session key ${JSON.stringify(sessionKey)} does not belong to conversation ` +\n        JSON.stringify(conversationId),\n    );\n  }\n  const suffix = threadSuffixOf(sessionKey);\n  if (suffix !== null) assertSessionSuffix(suffix);\n  return sessionKey;\n}\n\n/**\n * The runtime fallback: honor a platform-computed session key, otherwise\n * scope the event to its thread (or to itself for thread-starting messages).\n */\nexport function deriveSessionKey(event: {\n  sessionKey?: string;\n  conversationId: string;\n  thread_ts?: string;\n  ts: string;\n}): string {\n  if (event.sessionKey !== undefined) {\n    return assertSessionKeyBelongsToConversation(event.sessionKey, event.conversationId);\n  }\n  return makeThreadSessionKey(event.conversationId, event.thread_ts ?? event.ts);\n}\n\nexport function isThreadSessionKey(sessionKey: string): boolean {\n  return sessionKey.includes(\":\");\n}\n\n/** The conversation a session key belongs to (identity for bare keys). */\nexport function conversationIdOf(sessionKey: string): string {\n  const separator = sessionKey.indexOf(\":\");\n  return separator === -1 ? sessionKey : sessionKey.slice(0, separator);\n}\n\n/** The thread suffix of a scoped key, or null for a bare conversation key. */\nexport function threadSuffixOf(sessionKey: string): string | null {\n  const separator = sessionKey.indexOf(\":\");\n  return separator === -1 ? null : sessionKey.slice(separator + 1);\n}\n\nexport function resolveChatSessionKey(options: ResolveSessionKeyOptions): string {\n  const {\n    conversationId,\n    conversationKind,\n    messageId,\n    persistentTopLevel,\n    scopeDirectThreads,\n    threadTs,\n  } = options;\n  if (conversationKind === \"direct\" && (!threadTs || !scopeDirectThreads)) {\n    return assertConversationId(conversationId);\n  }\n  if (!threadTs && persistentTopLevel) {\n    return assertConversationId(conversationId);\n  }\n  return makeThreadSessionKey(conversationId, threadTs || messageId);\n}\n\nexport function inferConversationKind(platform: string, conversationId: string): ConversationKind {\n  if (platform === \"slack\") {\n    return conversationId.startsWith(\"D\") ? \"direct\" : \"shared\";\n  }\n\n  if (platform === \"telegram\") {\n    return conversationId.startsWith(\"-\") ? \"shared\" : \"direct\";\n  }\n\n  if (platform === \"discord\") {\n    return conversationId.startsWith(\"DM\") ? \"direct\" : \"shared\";\n  }\n\n  // github: issues/PRs are always shared within the repo; there are no DMs.\n  return \"shared\";\n}\n"]}
+{"version":3,"file":"session-key.js","sourceRoot":"","sources":["../../src/sessions/session-key.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConversationKind, OfficeAddress } from \"../types.js\";\nexport type { ResolveSessionKeyOptions } from \"./types.js\";\nimport type { ResolveSessionKeyOptions } from \"./types.js\";\n\nconst PATH_SEPARATOR_PATTERN = /[\\\\/]/;\n\nfunction containsControlCharacter(value: string): boolean {\n  for (const character of value) {\n    const codePoint = character.codePointAt(0)!;\n    if (codePoint <= 0x1f || codePoint === 0x7f) return true;\n  }\n  return false;\n}\n\nfunction assertSafeIdentityPart(value: string, label: string): string {\n  if (!value || value === \".\" || value === \"..\") {\n    throw new Error(`${label} must be a non-empty identity segment (got ${JSON.stringify(value)})`);\n  }\n  if (PATH_SEPARATOR_PATTERN.test(value)) {\n    throw new Error(`${label} must not contain path separators (got ${JSON.stringify(value)})`);\n  }\n  if (containsControlCharacter(value)) {\n    throw new Error(`${label} must not contain control characters (got ${JSON.stringify(value)})`);\n  }\n  return value;\n}\n\nexport function assertSessionConversationId(conversationId: string): string {\n  assertSafeIdentityPart(conversationId, \"Conversation id\");\n  if (conversationId.includes(\":\")) {\n    throw new Error(\n      `Conversation id must not contain \":\" (got ${JSON.stringify(conversationId)}); ` +\n        \"the session-key grammar reserves it for thread suffixes\",\n    );\n  }\n  return conversationId;\n}\n\nexport function assertSessionSuffix(suffix: string): string {\n  return assertSafeIdentityPart(suffix, \"Session suffix\");\n}\n\nexport function makeThreadSessionKey(conversationId: string, suffix: string): string {\n  return `${assertSessionConversationId(conversationId)}:${assertSessionSuffix(suffix)}`;\n}\n\nexport function assertSessionKeyBelongsToConversation(\n  sessionKey: string,\n  conversationId: string,\n): string {\n  const expectedConversationId = assertSessionConversationId(conversationId);\n  const actualConversationId = conversationIdOf(sessionKey);\n  if (actualConversationId !== expectedConversationId) {\n    throw new Error(\n      `Session key ${JSON.stringify(sessionKey)} does not belong to conversation ` +\n        JSON.stringify(conversationId),\n    );\n  }\n  const suffix = threadSuffixOf(sessionKey);\n  if (suffix !== null) assertSessionSuffix(suffix);\n  return sessionKey;\n}\n\nexport function deriveSessionKey(event: {\n  address: OfficeAddress;\n  sessionKey?: string;\n  thread_ts?: string;\n  ts: string;\n}): string {\n  const conversationId = event.address.conversationId;\n  if (event.sessionKey !== undefined) {\n    return assertSessionKeyBelongsToConversation(event.sessionKey, conversationId);\n  }\n  return makeThreadSessionKey(conversationId, event.thread_ts ?? event.ts);\n}\n\nexport function isThreadSessionKey(sessionKey: string): boolean {\n  return sessionKey.includes(\":\");\n}\n\nexport function conversationIdOf(sessionKey: string): string {\n  const separator = sessionKey.indexOf(\":\");\n  return separator === -1 ? sessionKey : sessionKey.slice(0, separator);\n}\n\nexport function threadSuffixOf(sessionKey: string): string | null {\n  const separator = sessionKey.indexOf(\":\");\n  return separator === -1 ? null : sessionKey.slice(separator + 1);\n}\n\nexport function resolveChatSessionKey(options: ResolveSessionKeyOptions): string {\n  const {\n    conversationId,\n    conversationKind,\n    messageId,\n    persistentTopLevel,\n    scopeDirectThreads,\n    threadTs,\n  } = options;\n  if (conversationKind === \"direct\" && (!threadTs || !scopeDirectThreads)) {\n    return assertSessionConversationId(conversationId);\n  }\n  if (!threadTs && persistentTopLevel) {\n    return assertSessionConversationId(conversationId);\n  }\n  return makeThreadSessionKey(conversationId, threadTs || messageId);\n}\n\nexport function inferConversationKind(platform: string, conversationId: string): ConversationKind {\n  if (platform === \"slack\") {\n    return conversationId.startsWith(\"D\") ? \"direct\" : \"shared\";\n  }\n\n  if (platform === \"telegram\") {\n    return conversationId.startsWith(\"-\") ? \"shared\" : \"direct\";\n  }\n\n  if (platform === \"discord\") {\n    return conversationId.startsWith(\"DM\") ? \"direct\" : \"shared\";\n  }\n\n  return \"shared\";\n}\n"]}

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

@@ -16,10 +16,8 @@ export declare class SessionStore implements SessionInspection {
     private harnessLane;
     private constructor();
     static open(path: string, cwdOverride?: string): Promise<SessionStore>;
-    /** Read native execution state without claiming the live file's writer. */
     static inspectExecution(path: string): Promise<{
         open: boolean;
-        /** False until the first operation is recorded: admitted, never run. */
         started: boolean;
         result?: {
             status: "completed" | "aborted" | "failed" | "declined";
@@ -42,17 +40,13 @@ export declare class SessionStore implements SessionInspection {
     getSessionName(): Promise<string | undefined>;
     getBranch(fromId?: string): Promise<Entry[]>;
     buildSessionContext(): Promise<SessionContext>;
-    /** Acquire host MCP capabilities under the same lifetime as the session writer. */
-    connectMcp(servers: Record<string, McpServerConfig>, signal?: AbortSignal): Promise<import("@earendil-works/pi-agent-core").AgentTool<import("@sinclair/typebox").TSchema, any>[]>;
-    /** MCP guidance remains attached when the caller refreshes its per-turn prompt. */
+    connectMcp(servers: Record<string, McpServerConfig>, signal?: AbortSignal): Promise<import("../harness/types.js").MikanHarnessTool[]>;
     withMcpInstructions(prompt: string): string;
-    /** Attach Pi's runtime to this store's sole writable Session. */
     createHarness(options: Omit<AgentHarnessOptions, "session">): Promise<AgentHarness>;
     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;

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

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/sessions/session-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/sessions/session-store.ts"],"names":[],"mappings":"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"}

package/dist/sessions/session-store.js

@@ -1,16 +1,7 @@
-/**
- * mikan-owned facade over Pi's current JSONL v4 SessionRepo.
- *
- * Pi owns entry, branch, value, transaction, and storage validation. mikan
- * owns exact file paths, single-writer leases, lazy materialization, lineage
- * metadata, and the stable inspection API consumed by platform runtimes.
- * Older session generations are rejected and converted only by the offline
- * `mikan sessions migrate` command.
- */
 import { closeSync, existsSync, fstatSync, ftruncateSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, realpathSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
-import { AgentHarness, branchTip, laneState, operationResult, createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, insertEntry, JsonlSessionRepo, MemorySessionRepo, setValue, TODO_CONTEXT, uuidv7, value, } from "@earendil-works/pi-agent-core";
+import { AgentHarness, laneState, operationResult, createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, JsonlSessionRepo, JSONL_STORAGE_VERSION, MemorySessionRepo, TODO_CONTEXT, uuidv7, value, } from "@earendil-works/pi-agent-core";
 import { NodeExecutionEnv } from "@earendil-works/pi-agent-core/node";
 import { atomicWritePrivateFile } from "../file-guards.js";
 import { CURRENT_SESSION_VERSION } from "./types.js";
@@ -105,14 +96,17 @@ function parseCurrentHeader(filePath, firstLine) {
     catch {
         throw new SessionFormatError(`Session file header is not valid JSON: ${filePath}`);
     }
+    if (!isMetadataRecord(parsed)) {
+        throw new SessionFormatError(`Session file has an unrecognized header: ${filePath}`);
+    }
     const record = parsed;
     if (record.type === "session" || (record.kind === "header" && record.version === 4)) {
         const generation = record.type === "session" ? "legacy v3" : "Pi 0.84 v4";
         throw new SessionFormatError(`Session file uses the ${generation} format: ${filePath}. Run \`mikan sessions migrate\` before starting this mikan version.`);
     }
     if (record.kind !== "header" ||
-        record.v !== 4 ||
-        record.storageVersion !== 1 ||
+        record.v !== CURRENT_SESSION_VERSION ||
+        record.storageVersion !== JSONL_STORAGE_VERSION ||
         typeof record.id !== "string" ||
         typeof record.createdAt !== "number" ||
         typeof record.cwd !== "string") {
@@ -134,12 +128,6 @@ function metadataFromHeader(header, path) {
             : {}),
     };
 }
-/**
- * Hand-rolled JSONL scan kept only for the synchronous `readHeader` path,
- * which must read metadata without opening a Session. `open`/`inspect`
- * instead read it via `session.getValue(MIKAN_METADATA, ...)` once a
- * Session exists, so pi owns that decoding.
- */
 function parseMikanMetadata(filePath) {
     let current;
     for (const line of readFileSync(filePath, "utf-8").split("\n").slice(1)) {
@@ -212,10 +200,10 @@ function buildHeader(cwd, options) {
         : { parentSessionPath: options.parentSession };
     return {
         header: {
-            v: 4,
+            v: CURRENT_SESSION_VERSION,
             kind: "header",
             id: options?.id ?? uuidv7(),
-            storageVersion: 1,
+            storageVersion: JSONL_STORAGE_VERSION,
             createdAt: Date.now(),
             cwd,
             ...(options?.parentSessionId !== undefined
@@ -257,7 +245,6 @@ async function openFileSession(path, header) {
         throw error;
     }
 }
-/** Both inspection surfaces share one snapshot lifetime; neither claims the source writer. */
 async function withSessionSnapshot(path, read) {
     const resolvedPath = canonicalSessionPath(path);
     const dir = mkdtempSync(join(tmpdir(), "mikan-session-inspect-"));
@@ -380,7 +367,6 @@ export class SessionStore {
             throw error;
         }
     }
-    /** Read native execution state without claiming the live file's writer. */
     static async inspectExecution(path) {
         return withSessionSnapshot(path, async (session) => {
             const state = (await session.getValue(laneState("main"), TODO_CONTEXT))?.value;
@@ -519,7 +505,6 @@ export class SessionStore {
     async buildSessionContext() {
         return buildContext(await this.getBranch());
     }
-    /** Acquire host MCP capabilities under the same lifetime as the session writer. */
     async connectMcp(servers, signal) {
         return this.mutate(async () => {
             if (this.mcp)
@@ -532,12 +517,10 @@ export class SessionStore {
             return this.mcp.tools;
         });
     }
-    /** MCP guidance remains attached when the caller refreshes its per-turn prompt. */
     withMcpInstructions(prompt) {
         const instructions = formatMcpServerInstructions(this.mcp?.instructions ?? []);
         return instructions ? `${prompt}\n\n${instructions}` : prompt;
     }
-    /** Attach Pi's runtime to this store's sole writable Session. */
     async createHarness(options) {
         return this.mutate(async () => {
             if (this.harness)
@@ -576,31 +559,6 @@ export class SessionStore {
     async setSessionName(name) {
         await this.mutate(async () => (await this.live()).session.setName(name.trim() || undefined, TODO_CONTEXT));
     }
-    async appendCompaction(summary, retainedTail, tokensBefore, details) {
-        return this.mutate(async () => {
-            if (this.harness)
-                throw new Error("Compaction is owned by the attached Pi harness");
-            const { session } = await this.live();
-            const id = session.idGenerator.next();
-            await session.mutate(async (mutator, context) => {
-                const currentTip = await mutator.getValue(branchTip("main"), context);
-                await mutator.commit([
-                    insertEntry({
-                        type: "compaction",
-                        id,
-                        parentId: currentTip?.value ?? null,
-                        summary,
-                        retainedTail: toDurable(retainedTail),
-                        tokensBefore,
-                        fromHook: false,
-                        ...(details !== undefined ? { details: toDurable(details) } : {}),
-                    }),
-                    setValue(branchTip("main"), id),
-                ], context);
-            }, TODO_CONTEXT);
-            return id;
-        });
-    }
     async close() {
         if (this.closePromise)
             return this.closePromise;