@geminixiang/mikan 0.2.0

package/dist/sessions/policy.js

@@ -0,0 +1,23 @@
+export function resolveChatSessionKey(options) {
+    const { conversationId, conversationKind, messageId, persistentTopLevel, scopeDirectThreads, threadTs, } = options;
+    if (conversationKind === "direct" && (!threadTs || !scopeDirectThreads)) {
+        return conversationId;
+    }
+    if (!threadTs && persistentTopLevel) {
+        return conversationId;
+    }
+    return `${conversationId}:${threadTs || messageId}`;
+}
+export function inferConversationKind(platform, conversationId) {
+    if (platform === "slack") {
+        return conversationId.startsWith("D") ? "direct" : "shared";
+    }
+    if (platform === "telegram") {
+        return conversationId.startsWith("-") ? "shared" : "direct";
+    }
+    if (platform === "discord") {
+        return conversationId.startsWith("DM") ? "direct" : "shared";
+    }
+    return "shared";
+}
+//# sourceMappingURL=policy.js.map

package/dist/sessions/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/sessions/policy.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,qBAAqB,CAAC,OAAiC;IACrE,MAAM,EACJ,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,GACT,GAAG,OAAO,CAAC;IACZ,IAAI,gBAAgB,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACxE,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QACpC,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,cAAc,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAsB,EACtB,cAAsB;IAEtB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9D,CAAC;IAED,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9D,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\n\nexport type ChatPlatform = \"slack\" | \"telegram\" | \"discord\" | string;\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\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 conversationId;\n  }\n  if (!threadTs && persistentTopLevel) {\n    return conversationId;\n  }\n  return `${conversationId}:${threadTs || messageId}`;\n}\n\nexport function inferConversationKind(\n  platform: ChatPlatform,\n  conversationId: string,\n): 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/store.d.ts

@@ -0,0 +1,103 @@
+import { SessionManager } from "@earendil-works/pi-coding-agent";
+export declare class ThreadRootNotFoundError extends Error {
+    constructor(sessionFile: string);
+}
+export interface ThreadRootMessage {
+    text?: string;
+    userName?: string;
+    user?: string;
+    loggedAt?: number;
+}
+export interface ResolvedSessionScope {
+    sessionDir: string;
+    contextFile: string;
+    threadRootMessage: ThreadRootMessage | null;
+}
+export interface ResolveGenericSessionScopeOptions {
+    conversationDir: string;
+    sessionKey: string;
+    cwd?: string;
+}
+/**
+ * Returns the shared session directory for a conversation.
+ * Channel sessions use a current pointer within this directory.
+ * Thread sessions are stored as fixed files within the same directory.
+ */
+export declare function getChannelSessionDir(channelDir: string): string;
+/**
+ * Resolves the current active session file for a session directory.
+ * Reads the "current" pointer file; creates a new session if none exists
+ * or the pointed-to file is missing.
+ */
+export declare function resolveSessionFile(sessionDir: string): string;
+/**
+ * Resolve the current active session file for a session directory.
+ * Creates a fully initialized persistent session with the provided cwd when none exists.
+ */
+export declare function resolveManagedSessionFile(sessionDir: string, cwd: string): string;
+/**
+ * Extracts the short UUID from a session file path.
+ * e.g. "2026-04-05T00-00_7b54cf90.jsonl" → "7b54cf90"
+ */
+export declare function extractSessionUuid(sessionFile: string): string;
+/**
+ * Extracts the thread/suffix part of a session key.
+ * "channelId:threadId" → "threadId", "channelId" → "channelId"
+ */
+export declare function extractSessionSuffix(sessionKey: string): string;
+/**
+ * Creates an empty timestamped file and updates the "current" pointer.
+ * Used only by tests for placeholder-file scenarios.
+ *
+ * Order matters: write the session file first, then atomic-rename the pointer
+ * last so a crash mid-create never leaves "current" pointing at a missing file.
+ */
+export declare function createNewSessionFile(sessionDir: string): string;
+/**
+ * Creates a new persistent session file with a proper SessionManager header and cwd.
+ * Also updates the "current" pointer. Header is written before the pointer flips so a
+ * partial create cannot leave "current" pointing at a missing file.
+ */
+export declare function createManagedSessionFile(sessionDir: string, cwd: string): string;
+/**
+ * Open a session file with an explicit cwd, even if the file does not exist yet.
+ * This avoids SessionManager.open() falling back to process.cwd() for fresh sessions.
+ */
+export declare function openManagedSession(sessionFile: string, sessionDir: string, cwd: string): SessionManager;
+/**
+ * Creates or overwrites a fixed-path session file with a valid session header.
+ */
+export declare function createManagedSessionFileAtPath(sessionFile: string, cwd: string): string;
+/**
+ * Returns the fixed session file path for a Slack thread.
+ */
+export declare function getThreadSessionFile(channelDir: string, sessionKey: string): string;
+/**
+ * Resolve the default session scope for platforms without Slack-style branch forking.
+ * Top-level/private sessions use the conversation's current pointer. Threaded or
+ * per-message sessions use a fixed file derived from the session key suffix.
+ */
+export declare function resolveGenericSessionScope(options: ResolveGenericSessionScopeOptions): ResolvedSessionScope;
+/**
+ * Try to resolve an existing current session file.
+ * Returns null if no current pointer exists or the pointed file has no valid session header.
+ */
+export declare function tryResolveCurrentSession(sessionDir: string): string | null;
+/**
+ * Try to resolve an existing thread session file.
+ * Returns the file path if found, or null if no valid thread session exists yet.
+ */
+export declare function tryResolveThreadSession(sessionFile: string): string | null;
+/**
+ * Resolve the channel's current session file path (for fork source).
+ * Returns null if no channel session exists.
+ */
+export declare function resolveChannelSessionFile(channelDir: string): string | null;
+/**
+ * Fork a channel session into a fixed thread-session path.
+ * The resulting file keeps forkFrom's distinct session/header metadata.
+ */
+export declare function forkThreadSessionFile(sourceSessionFile: string, targetSessionFile: string, cwd: string): string;
+export declare function createThreadSessionFileFromRootMessage(targetSessionFile: string, cwd: string, rootMessage: ThreadRootMessage, parentSession?: string): string;
+export declare function forkThreadSessionFileFromRootMessage(sourceSessionFile: string, targetSessionFile: string, cwd: string, rootMessage: ThreadRootMessage): string;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAKjE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,WAAW,EAAE,MAAM,EAG9B;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAcD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,cAAc,CAShB;AAQD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvF;AAeD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,oBAAoB,CAoBtB;AAuID;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,CAWR;AAED,wBAAgB,sCAAsC,CACpD,iBAAiB,EAAE,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,iBAAiB,EAC9B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAiCR;AAED,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,iBAAiB,GAC7B,MAAM,CAqBR","sourcesContent":["import { randomUUID } from \"crypto\";\nimport { existsSync, mkdirSync, renameSync, rmSync } from \"fs\";\nimport { join } from \"path\";\nimport { SessionManager } from \"@earendil-works/pi-coding-agent\";\nimport { isRecord, parseJsonValue, readTextFileIfExists } from \"../file-guards.js\";\nimport { atomicWritePrivateFile } from \"../fs-atomic.js\";\nimport { isPlatformHistorySession } from \"./metadata.js\";\n\nexport class ThreadRootNotFoundError extends Error {\n  constructor(sessionFile: string) {\n    super(`Thread root message not found in source session: ${sessionFile}`);\n    this.name = \"ThreadRootNotFoundError\";\n  }\n}\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\nexport interface ResolveGenericSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\ninterface SessionMessageEntryLike {\n  type: string;\n  id: string;\n  parentId: string | null;\n  timestamp: string;\n  message?: {\n    role?: string;\n    timestamp?: number;\n    content?: Array<{ type?: string; text?: string }> | string;\n  };\n}\n\n/**\n * Returns the shared session directory for a conversation.\n * Channel sessions use a current pointer within this directory.\n * Thread sessions are stored as fixed files within the same directory.\n */\nexport function getChannelSessionDir(channelDir: string): string {\n  return join(channelDir, \"sessions\");\n}\n\n/**\n * Resolves the current active session file for a session directory.\n * Reads the \"current\" pointer file; creates a new session if none exists\n * or the pointed-to file is missing.\n */\nexport function resolveSessionFile(sessionDir: string): string {\n  const existing = tryResolveCurrentSession(sessionDir);\n  if (existing) return existing;\n  return createNewSessionFile(sessionDir);\n}\n\n/**\n * Resolve the current active session file for a session directory.\n * Creates a fully initialized persistent session with the provided cwd when none exists.\n */\nexport function resolveManagedSessionFile(sessionDir: string, cwd: string): string {\n  const existingPath = getCurrentSessionPath(sessionDir);\n  if (existingPath && !isPlatformHistorySession(existingPath)) return existingPath;\n  return createManagedSessionFile(sessionDir, cwd);\n}\n\n/**\n * Extracts the short UUID from a session file path.\n * e.g. \"2026-04-05T00-00_7b54cf90.jsonl\" → \"7b54cf90\"\n */\nexport function extractSessionUuid(sessionFile: string): string {\n  const base = sessionFile.split(\"/\").pop() ?? sessionFile;\n  return base.replace(\".jsonl\", \"\").split(\"_\").pop() ?? base;\n}\n\n/**\n * Extracts the thread/suffix part of a session key.\n * \"channelId:threadId\" → \"threadId\", \"channelId\" → \"channelId\"\n */\nexport function extractSessionSuffix(sessionKey: string): string {\n  const parts = sessionKey.split(\":\");\n  return parts.length > 1 ? parts[parts.length - 1] : sessionKey;\n}\n\n/**\n * Creates an empty timestamped file and updates the \"current\" pointer.\n * Used only by tests for placeholder-file scenarios.\n *\n * Order matters: write the session file first, then atomic-rename the pointer\n * last so a crash mid-create never leaves \"current\" pointing at a missing file.\n */\nexport function createNewSessionFile(sessionDir: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const uuid = randomUUID().slice(0, 8);\n  const filename = `${timestamp}_${uuid}.jsonl`;\n  const filePath = join(sessionDir, filename);\n  atomicWritePrivateFile(filePath, \"\");\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n  return filePath;\n}\n\n/**\n * Creates a new persistent session file with a proper SessionManager header and cwd.\n * Also updates the \"current\" pointer. Header is written before the pointer flips so a\n * partial create cannot leave \"current\" pointing at a missing file.\n */\nexport function createManagedSessionFile(sessionDir: string, cwd: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const sessionId = randomUUID();\n  const sessionFile = join(sessionDir, `${timestamp}_${sessionId.slice(0, 8)}.jsonl`);\n  writeSessionHeader(sessionFile, cwd, sessionId);\n  setCurrentPointer(sessionDir, sessionFile);\n  return sessionFile;\n}\n\n/**\n * Open a session file with an explicit cwd, even if the file does not exist yet.\n * This avoids SessionManager.open() falling back to process.cwd() for fresh sessions.\n */\nexport function openManagedSession(\n  sessionFile: string,\n  sessionDir: string,\n  cwd: string,\n): SessionManager {\n  if (shouldRecreatePreinitializedSession(sessionFile)) {\n    rmSync(sessionFile, { force: true });\n  }\n\n  const SessionManagerCtor = SessionManager as unknown as {\n    new (cwd: string, sessionDir: string, sessionFile: string, persist: boolean): SessionManager;\n  };\n  return new SessionManagerCtor(cwd, sessionDir, sessionFile, true);\n}\n\nfunction setCurrentPointer(sessionDir: string, sessionFilePath: string): void {\n  const filename = sessionFilePath.split(\"/\").pop()!;\n  mkdirSync(sessionDir, { recursive: true });\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n}\n\n/**\n * Creates or overwrites a fixed-path session file with a valid session header.\n */\nexport function createManagedSessionFileAtPath(sessionFile: string, cwd: string): string {\n  writeSessionHeader(sessionFile, cwd);\n  return sessionFile;\n}\n\nfunction writeSessionHeader(sessionFile: string, cwd: string, sessionId = randomUUID()): void {\n  const sessionDir = getFileDir(sessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: sessionId,\n    timestamp: new Date().toISOString(),\n    cwd,\n  };\n  atomicWritePrivateFile(sessionFile, `${JSON.stringify(header)}\\n`);\n}\n\n/**\n * Returns the fixed session file path for a Slack thread.\n */\nexport function getThreadSessionFile(channelDir: string, sessionKey: string): string {\n  return join(getChannelSessionDir(channelDir), `${extractSessionSuffix(sessionKey)}.jsonl`);\n}\n\n/**\n * Resolve the default session scope for platforms without Slack-style branch forking.\n * Top-level/private sessions use the conversation's current pointer. Threaded or\n * per-message sessions use a fixed file derived from the session key suffix.\n */\nexport function resolveGenericSessionScope(\n  options: ResolveGenericSessionScopeOptions,\n): ResolvedSessionScope {\n  const { conversationDir, sessionKey } = options;\n  const cwd = options.cwd ?? conversationDir;\n  const sessionDir = getChannelSessionDir(conversationDir);\n\n  if (!sessionKey.includes(\":\")) {\n    return {\n      sessionDir,\n      contextFile: resolveManagedSessionFile(sessionDir, cwd),\n      threadRootMessage: null,\n    };\n  }\n\n  const threadFile = getThreadSessionFile(conversationDir, sessionKey);\n  return {\n    sessionDir,\n    contextFile:\n      tryResolveThreadSession(threadFile) ?? createManagedSessionFileAtPath(threadFile, cwd),\n    threadRootMessage: null,\n  };\n}\n\nfunction hasSessionHeader(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const lines = raw.split(\"\\n\");\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      const entry = parseJsonValue(\n        trimmed,\n        (value): value is { type?: string } => isRecord(value),\n        (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n      );\n      return entry.type === \"session\";\n    }\n  } catch {\n    return false;\n  }\n  return false;\n}\n\nfunction shouldRecreatePreinitializedSession(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const entries = raw\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map((line) =>\n        parseJsonValue(\n          line,\n          (value): value is { type?: string } => isRecord(value),\n          (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n        ),\n      );\n\n    return entries.length === 1 && entries[0]?.type === \"session\";\n  } catch {\n    return false;\n  }\n}\n\nfunction getFileDir(sessionFile: string): string {\n  return sessionFile.substring(0, sessionFile.lastIndexOf(\"/\"));\n}\n\nfunction resolveThreadSnapshotEntries(\n  sourceSessionFile: string,\n  rootMessage: ThreadRootMessage,\n): SessionMessageEntryLike[] | null {\n  const targetText = buildComparableRootMessageText(rootMessage);\n  if (!targetText) return null;\n\n  const entries = SessionManager.open(sourceSessionFile).getEntries() as SessionMessageEntryLike[];\n  const matchIndex = findRootMessageIndex(entries, targetText, rootMessage.loggedAt);\n  if (matchIndex === -1) return null;\n\n  const nextTopLevelUserIndex = entries.findIndex(\n    (entry, index) => index > matchIndex && isUserMessageEntry(entry),\n  );\n  const endIndex = nextTopLevelUserIndex === -1 ? entries.length : nextTopLevelUserIndex;\n  return entries.slice(0, endIndex);\n}\n\nfunction findRootMessageIndex(\n  entries: SessionMessageEntryLike[],\n  targetText: string,\n  loggedAt?: number,\n): number {\n  for (let i = 0; i < entries.length; i++) {\n    const entry = entries[i];\n    if (!isUserMessageEntry(entry)) continue;\n\n    const comparableText = normalizeComparableUserText(getMessageText(entry));\n    if (comparableText !== targetText) continue;\n\n    const messageTimestamp = entry.message?.timestamp;\n    if (\n      loggedAt !== undefined &&\n      typeof messageTimestamp === \"number\" &&\n      messageTimestamp < loggedAt\n    ) {\n      continue;\n    }\n\n    return i;\n  }\n\n  return -1;\n}\n\nfunction isUserMessageEntry(entry: SessionMessageEntryLike): boolean {\n  return entry.type === \"message\" && entry.message?.role === \"user\";\n}\n\nfunction getMessageText(entry: SessionMessageEntryLike): string {\n  const content = entry.message?.content;\n  if (typeof content === \"string\") return content;\n  if (!Array.isArray(content)) return \"\";\n\n  return content\n    .filter((part): part is { type?: string; text?: string } => part.type === \"text\")\n    .map((part) => part.text ?? \"\")\n    .join(\"\\n\\n\");\n}\n\nfunction buildComparableRootMessageText(rootMessage: ThreadRootMessage): string | null {\n  const userLabel = rootMessage.userName || rootMessage.user || \"unknown\";\n  const text = rootMessage.text?.trim();\n  if (!text) return null;\n  return normalizeComparableUserText(`[${userLabel}]: ${text}`);\n}\n\nfunction stripSlackAttachmentBlock(text: string): string {\n  return text.replace(/\\n*<slack_attachments>\\n[\\s\\S]*?\\n<\\/slack_attachments>\\s*$/g, \"\");\n}\n\nfunction normalizeComparableUserText(text: string): string {\n  const withoutTimestamp = text.replace(\n    /^\\[[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}[+-][0-9]{2}:[0-9]{2}\\]\\s+(?=\\[[^\\]]+\\](?:\\s+\\[in-thread:[^\\]]+\\])?:\\s)/,\n    \"\",\n  );\n  return stripSlackAttachmentBlock(withoutTimestamp).trim();\n}\n\nfunction getCurrentSessionPath(sessionDir: string): string | null {\n  const pointerFile = join(sessionDir, \"current\");\n  const filename = readTextFileIfExists(pointerFile)?.trim();\n  if (!filename) return null;\n  return join(sessionDir, filename);\n}\n\n/**\n * Try to resolve an existing current session file.\n * Returns null if no current pointer exists or the pointed file has no valid session header.\n */\nexport function tryResolveCurrentSession(sessionDir: string): string | null {\n  const fullPath = getCurrentSessionPath(sessionDir);\n  if (fullPath && existsSync(fullPath) && hasSessionHeader(fullPath)) return fullPath;\n  return null;\n}\n\n/**\n * Try to resolve an existing thread session file.\n * Returns the file path if found, or null if no valid thread session exists yet.\n */\nexport function tryResolveThreadSession(sessionFile: string): string | null {\n  return existsSync(sessionFile) && hasSessionHeader(sessionFile) ? sessionFile : null;\n}\n\n/**\n * Resolve the channel's current session file path (for fork source).\n * Returns null if no channel session exists.\n */\nexport function resolveChannelSessionFile(channelDir: string): string | null {\n  return tryResolveCurrentSession(getChannelSessionDir(channelDir));\n}\n\n/**\n * Fork a channel session into a fixed thread-session path.\n * The resulting file keeps forkFrom's distinct session/header metadata.\n */\nexport function forkThreadSessionFile(\n  sourceSessionFile: string,\n  targetSessionFile: string,\n  cwd: string,\n): string {\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  const forked = SessionManager.forkFrom(sourceSessionFile, cwd, sessionDir);\n  const forkedFile = forked.getSessionFile();\n  if (!forkedFile) {\n    throw new Error(`Failed to fork session from ${sourceSessionFile}`);\n  }\n  rmSync(targetSessionFile, { force: true });\n  renameSync(forkedFile, targetSessionFile);\n  return targetSessionFile;\n}\n\nexport function createThreadSessionFileFromRootMessage(\n  targetSessionFile: string,\n  cwd: string,\n  rootMessage: ThreadRootMessage,\n  parentSession?: string,\n): string {\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  rmSync(targetSessionFile, { force: true });\n\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: randomUUID(),\n    timestamp: new Date().toISOString(),\n    cwd,\n    ...(parentSession ? { parentSession } : {}),\n  };\n  const rootText = buildComparableRootMessageText(rootMessage);\n  if (!rootText) {\n    atomicWritePrivateFile(targetSessionFile, `${JSON.stringify(header)}\\n`);\n    return targetSessionFile;\n  }\n\n  const rootEntry = {\n    type: \"message\",\n    id: randomUUID().slice(0, 8),\n    parentId: null,\n    timestamp: new Date().toISOString(),\n    message: {\n      role: \"user\",\n      content: [{ type: \"text\", text: rootText }],\n      ...(rootMessage.loggedAt !== undefined ? { timestamp: rootMessage.loggedAt } : {}),\n    },\n  };\n  const content = [header, rootEntry].map((entry) => JSON.stringify(entry)).join(\"\\n\");\n  atomicWritePrivateFile(targetSessionFile, `${content}\\n`);\n  return targetSessionFile;\n}\n\nexport function forkThreadSessionFileFromRootMessage(\n  sourceSessionFile: string,\n  targetSessionFile: string,\n  cwd: string,\n  rootMessage: ThreadRootMessage,\n): string {\n  const snapshotEntries = resolveThreadSnapshotEntries(sourceSessionFile, rootMessage);\n  if (!snapshotEntries) {\n    throw new ThreadRootNotFoundError(sourceSessionFile);\n  }\n\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  rmSync(targetSessionFile, { force: true });\n\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: randomUUID(),\n    timestamp: new Date().toISOString(),\n    cwd,\n    parentSession: sourceSessionFile,\n  };\n  const content = [header, ...snapshotEntries].map((entry) => JSON.stringify(entry)).join(\"\\n\");\n  atomicWritePrivateFile(targetSessionFile, `${content}\\n`);\n  return targetSessionFile;\n}\n"]}

package/dist/sessions/store.js

@@ -0,0 +1,349 @@
+import { randomUUID } from "crypto";
+import { existsSync, mkdirSync, renameSync, rmSync } from "fs";
+import { join } from "path";
+import { SessionManager } from "@earendil-works/pi-coding-agent";
+import { isRecord, parseJsonValue, readTextFileIfExists } from "../file-guards.js";
+import { atomicWritePrivateFile } from "../fs-atomic.js";
+import { isPlatformHistorySession } from "./metadata.js";
+export class ThreadRootNotFoundError extends Error {
+    constructor(sessionFile) {
+        super(`Thread root message not found in source session: ${sessionFile}`);
+        this.name = "ThreadRootNotFoundError";
+    }
+}
+/**
+ * Returns the shared session directory for a conversation.
+ * Channel sessions use a current pointer within this directory.
+ * Thread sessions are stored as fixed files within the same directory.
+ */
+export function getChannelSessionDir(channelDir) {
+    return join(channelDir, "sessions");
+}
+/**
+ * Resolves the current active session file for a session directory.
+ * Reads the "current" pointer file; creates a new session if none exists
+ * or the pointed-to file is missing.
+ */
+export function resolveSessionFile(sessionDir) {
+    const existing = tryResolveCurrentSession(sessionDir);
+    if (existing)
+        return existing;
+    return createNewSessionFile(sessionDir);
+}
+/**
+ * Resolve the current active session file for a session directory.
+ * Creates a fully initialized persistent session with the provided cwd when none exists.
+ */
+export function resolveManagedSessionFile(sessionDir, cwd) {
+    const existingPath = getCurrentSessionPath(sessionDir);
+    if (existingPath && !isPlatformHistorySession(existingPath))
+        return existingPath;
+    return createManagedSessionFile(sessionDir, cwd);
+}
+/**
+ * Extracts the short UUID from a session file path.
+ * e.g. "2026-04-05T00-00_7b54cf90.jsonl" → "7b54cf90"
+ */
+export function extractSessionUuid(sessionFile) {
+    const base = sessionFile.split("/").pop() ?? sessionFile;
+    return base.replace(".jsonl", "").split("_").pop() ?? base;
+}
+/**
+ * Extracts the thread/suffix part of a session key.
+ * "channelId:threadId" → "threadId", "channelId" → "channelId"
+ */
+export function extractSessionSuffix(sessionKey) {
+    const parts = sessionKey.split(":");
+    return parts.length > 1 ? parts[parts.length - 1] : sessionKey;
+}
+/**
+ * Creates an empty timestamped file and updates the "current" pointer.
+ * Used only by tests for placeholder-file scenarios.
+ *
+ * Order matters: write the session file first, then atomic-rename the pointer
+ * last so a crash mid-create never leaves "current" pointing at a missing file.
+ */
+export function createNewSessionFile(sessionDir) {
+    mkdirSync(sessionDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const uuid = randomUUID().slice(0, 8);
+    const filename = `${timestamp}_${uuid}.jsonl`;
+    const filePath = join(sessionDir, filename);
+    atomicWritePrivateFile(filePath, "");
+    atomicWritePrivateFile(join(sessionDir, "current"), filename);
+    return filePath;
+}
+/**
+ * Creates a new persistent session file with a proper SessionManager header and cwd.
+ * Also updates the "current" pointer. Header is written before the pointer flips so a
+ * partial create cannot leave "current" pointing at a missing file.
+ */
+export function createManagedSessionFile(sessionDir, cwd) {
+    mkdirSync(sessionDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const sessionId = randomUUID();
+    const sessionFile = join(sessionDir, `${timestamp}_${sessionId.slice(0, 8)}.jsonl`);
+    writeSessionHeader(sessionFile, cwd, sessionId);
+    setCurrentPointer(sessionDir, sessionFile);
+    return sessionFile;
+}
+/**
+ * Open a session file with an explicit cwd, even if the file does not exist yet.
+ * This avoids SessionManager.open() falling back to process.cwd() for fresh sessions.
+ */
+export function openManagedSession(sessionFile, sessionDir, cwd) {
+    if (shouldRecreatePreinitializedSession(sessionFile)) {
+        rmSync(sessionFile, { force: true });
+    }
+    const SessionManagerCtor = SessionManager;
+    return new SessionManagerCtor(cwd, sessionDir, sessionFile, true);
+}
+function setCurrentPointer(sessionDir, sessionFilePath) {
+    const filename = sessionFilePath.split("/").pop();
+    mkdirSync(sessionDir, { recursive: true });
+    atomicWritePrivateFile(join(sessionDir, "current"), filename);
+}
+/**
+ * Creates or overwrites a fixed-path session file with a valid session header.
+ */
+export function createManagedSessionFileAtPath(sessionFile, cwd) {
+    writeSessionHeader(sessionFile, cwd);
+    return sessionFile;
+}
+function writeSessionHeader(sessionFile, cwd, sessionId = randomUUID()) {
+    const sessionDir = getFileDir(sessionFile);
+    mkdirSync(sessionDir, { recursive: true });
+    const header = {
+        type: "session",
+        version: 3,
+        id: sessionId,
+        timestamp: new Date().toISOString(),
+        cwd,
+    };
+    atomicWritePrivateFile(sessionFile, `${JSON.stringify(header)}\n`);
+}
+/**
+ * Returns the fixed session file path for a Slack thread.
+ */
+export function getThreadSessionFile(channelDir, sessionKey) {
+    return join(getChannelSessionDir(channelDir), `${extractSessionSuffix(sessionKey)}.jsonl`);
+}
+/**
+ * Resolve the default session scope for platforms without Slack-style branch forking.
+ * Top-level/private sessions use the conversation's current pointer. Threaded or
+ * per-message sessions use a fixed file derived from the session key suffix.
+ */
+export function resolveGenericSessionScope(options) {
+    const { conversationDir, sessionKey } = options;
+    const cwd = options.cwd ?? conversationDir;
+    const sessionDir = getChannelSessionDir(conversationDir);
+    if (!sessionKey.includes(":")) {
+        return {
+            sessionDir,
+            contextFile: resolveManagedSessionFile(sessionDir, cwd),
+            threadRootMessage: null,
+        };
+    }
+    const threadFile = getThreadSessionFile(conversationDir, sessionKey);
+    return {
+        sessionDir,
+        contextFile: tryResolveThreadSession(threadFile) ?? createManagedSessionFileAtPath(threadFile, cwd),
+        threadRootMessage: null,
+    };
+}
+function hasSessionHeader(sessionFile) {
+    try {
+        const raw = readTextFileIfExists(sessionFile);
+        if (raw === undefined)
+            return false;
+        const lines = raw.split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const entry = parseJsonValue(trimmed, (value) => isRecord(value), (detail) => (detail === "unexpected JSON shape" ? "expected a JSON object" : detail));
+            return entry.type === "session";
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
+function shouldRecreatePreinitializedSession(sessionFile) {
+    try {
+        const raw = readTextFileIfExists(sessionFile);
+        if (raw === undefined)
+            return false;
+        const entries = raw
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => parseJsonValue(line, (value) => isRecord(value), (detail) => (detail === "unexpected JSON shape" ? "expected a JSON object" : detail)));
+        return entries.length === 1 && entries[0]?.type === "session";
+    }
+    catch {
+        return false;
+    }
+}
+function getFileDir(sessionFile) {
+    return sessionFile.substring(0, sessionFile.lastIndexOf("/"));
+}
+function resolveThreadSnapshotEntries(sourceSessionFile, rootMessage) {
+    const targetText = buildComparableRootMessageText(rootMessage);
+    if (!targetText)
+        return null;
+    const entries = SessionManager.open(sourceSessionFile).getEntries();
+    const matchIndex = findRootMessageIndex(entries, targetText, rootMessage.loggedAt);
+    if (matchIndex === -1)
+        return null;
+    const nextTopLevelUserIndex = entries.findIndex((entry, index) => index > matchIndex && isUserMessageEntry(entry));
+    const endIndex = nextTopLevelUserIndex === -1 ? entries.length : nextTopLevelUserIndex;
+    return entries.slice(0, endIndex);
+}
+function findRootMessageIndex(entries, targetText, loggedAt) {
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        if (!isUserMessageEntry(entry))
+            continue;
+        const comparableText = normalizeComparableUserText(getMessageText(entry));
+        if (comparableText !== targetText)
+            continue;
+        const messageTimestamp = entry.message?.timestamp;
+        if (loggedAt !== undefined &&
+            typeof messageTimestamp === "number" &&
+            messageTimestamp < loggedAt) {
+            continue;
+        }
+        return i;
+    }
+    return -1;
+}
+function isUserMessageEntry(entry) {
+    return entry.type === "message" && entry.message?.role === "user";
+}
+function getMessageText(entry) {
+    const content = entry.message?.content;
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text ?? "")
+        .join("\n\n");
+}
+function buildComparableRootMessageText(rootMessage) {
+    const userLabel = rootMessage.userName || rootMessage.user || "unknown";
+    const text = rootMessage.text?.trim();
+    if (!text)
+        return null;
+    return normalizeComparableUserText(`[${userLabel}]: ${text}`);
+}
+function stripSlackAttachmentBlock(text) {
+    return text.replace(/\n*<slack_attachments>\n[\s\S]*?\n<\/slack_attachments>\s*$/g, "");
+}
+function normalizeComparableUserText(text) {
+    const withoutTimestamp = text.replace(/^\[[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}[+-][0-9]{2}:[0-9]{2}\]\s+(?=\[[^\]]+\](?:\s+\[in-thread:[^\]]+\])?:\s)/, "");
+    return stripSlackAttachmentBlock(withoutTimestamp).trim();
+}
+function getCurrentSessionPath(sessionDir) {
+    const pointerFile = join(sessionDir, "current");
+    const filename = readTextFileIfExists(pointerFile)?.trim();
+    if (!filename)
+        return null;
+    return join(sessionDir, filename);
+}
+/**
+ * Try to resolve an existing current session file.
+ * Returns null if no current pointer exists or the pointed file has no valid session header.
+ */
+export function tryResolveCurrentSession(sessionDir) {
+    const fullPath = getCurrentSessionPath(sessionDir);
+    if (fullPath && existsSync(fullPath) && hasSessionHeader(fullPath))
+        return fullPath;
+    return null;
+}
+/**
+ * Try to resolve an existing thread session file.
+ * Returns the file path if found, or null if no valid thread session exists yet.
+ */
+export function tryResolveThreadSession(sessionFile) {
+    return existsSync(sessionFile) && hasSessionHeader(sessionFile) ? sessionFile : null;
+}
+/**
+ * Resolve the channel's current session file path (for fork source).
+ * Returns null if no channel session exists.
+ */
+export function resolveChannelSessionFile(channelDir) {
+    return tryResolveCurrentSession(getChannelSessionDir(channelDir));
+}
+/**
+ * Fork a channel session into a fixed thread-session path.
+ * The resulting file keeps forkFrom's distinct session/header metadata.
+ */
+export function forkThreadSessionFile(sourceSessionFile, targetSessionFile, cwd) {
+    const sessionDir = getFileDir(targetSessionFile);
+    mkdirSync(sessionDir, { recursive: true });
+    const forked = SessionManager.forkFrom(sourceSessionFile, cwd, sessionDir);
+    const forkedFile = forked.getSessionFile();
+    if (!forkedFile) {
+        throw new Error(`Failed to fork session from ${sourceSessionFile}`);
+    }
+    rmSync(targetSessionFile, { force: true });
+    renameSync(forkedFile, targetSessionFile);
+    return targetSessionFile;
+}
+export function createThreadSessionFileFromRootMessage(targetSessionFile, cwd, rootMessage, parentSession) {
+    const sessionDir = getFileDir(targetSessionFile);
+    mkdirSync(sessionDir, { recursive: true });
+    rmSync(targetSessionFile, { force: true });
+    const header = {
+        type: "session",
+        version: 3,
+        id: randomUUID(),
+        timestamp: new Date().toISOString(),
+        cwd,
+        ...(parentSession ? { parentSession } : {}),
+    };
+    const rootText = buildComparableRootMessageText(rootMessage);
+    if (!rootText) {
+        atomicWritePrivateFile(targetSessionFile, `${JSON.stringify(header)}\n`);
+        return targetSessionFile;
+    }
+    const rootEntry = {
+        type: "message",
+        id: randomUUID().slice(0, 8),
+        parentId: null,
+        timestamp: new Date().toISOString(),
+        message: {
+            role: "user",
+            content: [{ type: "text", text: rootText }],
+            ...(rootMessage.loggedAt !== undefined ? { timestamp: rootMessage.loggedAt } : {}),
+        },
+    };
+    const content = [header, rootEntry].map((entry) => JSON.stringify(entry)).join("\n");
+    atomicWritePrivateFile(targetSessionFile, `${content}\n`);
+    return targetSessionFile;
+}
+export function forkThreadSessionFileFromRootMessage(sourceSessionFile, targetSessionFile, cwd, rootMessage) {
+    const snapshotEntries = resolveThreadSnapshotEntries(sourceSessionFile, rootMessage);
+    if (!snapshotEntries) {
+        throw new ThreadRootNotFoundError(sourceSessionFile);
+    }
+    const sessionDir = getFileDir(targetSessionFile);
+    mkdirSync(sessionDir, { recursive: true });
+    rmSync(targetSessionFile, { force: true });
+    const header = {
+        type: "session",
+        version: 3,
+        id: randomUUID(),
+        timestamp: new Date().toISOString(),
+        cwd,
+        parentSession: sourceSessionFile,
+    };
+    const content = [header, ...snapshotEntries].map((entry) => JSON.stringify(entry)).join("\n");
+    atomicWritePrivateFile(targetSessionFile, `${content}\n`);
+    return targetSessionFile;
+}
+//# sourceMappingURL=store.js.map

package/dist/sessions/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"crypto\";\nimport { existsSync, mkdirSync, renameSync, rmSync } from \"fs\";\nimport { join } from \"path\";\nimport { SessionManager } from \"@earendil-works/pi-coding-agent\";\nimport { isRecord, parseJsonValue, readTextFileIfExists } from \"../file-guards.js\";\nimport { atomicWritePrivateFile } from \"../fs-atomic.js\";\nimport { isPlatformHistorySession } from \"./metadata.js\";\n\nexport class ThreadRootNotFoundError extends Error {\n  constructor(sessionFile: string) {\n    super(`Thread root message not found in source session: ${sessionFile}`);\n    this.name = \"ThreadRootNotFoundError\";\n  }\n}\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\nexport interface ResolveGenericSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\ninterface SessionMessageEntryLike {\n  type: string;\n  id: string;\n  parentId: string | null;\n  timestamp: string;\n  message?: {\n    role?: string;\n    timestamp?: number;\n    content?: Array<{ type?: string; text?: string }> | string;\n  };\n}\n\n/**\n * Returns the shared session directory for a conversation.\n * Channel sessions use a current pointer within this directory.\n * Thread sessions are stored as fixed files within the same directory.\n */\nexport function getChannelSessionDir(channelDir: string): string {\n  return join(channelDir, \"sessions\");\n}\n\n/**\n * Resolves the current active session file for a session directory.\n * Reads the \"current\" pointer file; creates a new session if none exists\n * or the pointed-to file is missing.\n */\nexport function resolveSessionFile(sessionDir: string): string {\n  const existing = tryResolveCurrentSession(sessionDir);\n  if (existing) return existing;\n  return createNewSessionFile(sessionDir);\n}\n\n/**\n * Resolve the current active session file for a session directory.\n * Creates a fully initialized persistent session with the provided cwd when none exists.\n */\nexport function resolveManagedSessionFile(sessionDir: string, cwd: string): string {\n  const existingPath = getCurrentSessionPath(sessionDir);\n  if (existingPath && !isPlatformHistorySession(existingPath)) return existingPath;\n  return createManagedSessionFile(sessionDir, cwd);\n}\n\n/**\n * Extracts the short UUID from a session file path.\n * e.g. \"2026-04-05T00-00_7b54cf90.jsonl\" → \"7b54cf90\"\n */\nexport function extractSessionUuid(sessionFile: string): string {\n  const base = sessionFile.split(\"/\").pop() ?? sessionFile;\n  return base.replace(\".jsonl\", \"\").split(\"_\").pop() ?? base;\n}\n\n/**\n * Extracts the thread/suffix part of a session key.\n * \"channelId:threadId\" → \"threadId\", \"channelId\" → \"channelId\"\n */\nexport function extractSessionSuffix(sessionKey: string): string {\n  const parts = sessionKey.split(\":\");\n  return parts.length > 1 ? parts[parts.length - 1] : sessionKey;\n}\n\n/**\n * Creates an empty timestamped file and updates the \"current\" pointer.\n * Used only by tests for placeholder-file scenarios.\n *\n * Order matters: write the session file first, then atomic-rename the pointer\n * last so a crash mid-create never leaves \"current\" pointing at a missing file.\n */\nexport function createNewSessionFile(sessionDir: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const uuid = randomUUID().slice(0, 8);\n  const filename = `${timestamp}_${uuid}.jsonl`;\n  const filePath = join(sessionDir, filename);\n  atomicWritePrivateFile(filePath, \"\");\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n  return filePath;\n}\n\n/**\n * Creates a new persistent session file with a proper SessionManager header and cwd.\n * Also updates the \"current\" pointer. Header is written before the pointer flips so a\n * partial create cannot leave \"current\" pointing at a missing file.\n */\nexport function createManagedSessionFile(sessionDir: string, cwd: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  const sessionId = randomUUID();\n  const sessionFile = join(sessionDir, `${timestamp}_${sessionId.slice(0, 8)}.jsonl`);\n  writeSessionHeader(sessionFile, cwd, sessionId);\n  setCurrentPointer(sessionDir, sessionFile);\n  return sessionFile;\n}\n\n/**\n * Open a session file with an explicit cwd, even if the file does not exist yet.\n * This avoids SessionManager.open() falling back to process.cwd() for fresh sessions.\n */\nexport function openManagedSession(\n  sessionFile: string,\n  sessionDir: string,\n  cwd: string,\n): SessionManager {\n  if (shouldRecreatePreinitializedSession(sessionFile)) {\n    rmSync(sessionFile, { force: true });\n  }\n\n  const SessionManagerCtor = SessionManager as unknown as {\n    new (cwd: string, sessionDir: string, sessionFile: string, persist: boolean): SessionManager;\n  };\n  return new SessionManagerCtor(cwd, sessionDir, sessionFile, true);\n}\n\nfunction setCurrentPointer(sessionDir: string, sessionFilePath: string): void {\n  const filename = sessionFilePath.split(\"/\").pop()!;\n  mkdirSync(sessionDir, { recursive: true });\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n}\n\n/**\n * Creates or overwrites a fixed-path session file with a valid session header.\n */\nexport function createManagedSessionFileAtPath(sessionFile: string, cwd: string): string {\n  writeSessionHeader(sessionFile, cwd);\n  return sessionFile;\n}\n\nfunction writeSessionHeader(sessionFile: string, cwd: string, sessionId = randomUUID()): void {\n  const sessionDir = getFileDir(sessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: sessionId,\n    timestamp: new Date().toISOString(),\n    cwd,\n  };\n  atomicWritePrivateFile(sessionFile, `${JSON.stringify(header)}\\n`);\n}\n\n/**\n * Returns the fixed session file path for a Slack thread.\n */\nexport function getThreadSessionFile(channelDir: string, sessionKey: string): string {\n  return join(getChannelSessionDir(channelDir), `${extractSessionSuffix(sessionKey)}.jsonl`);\n}\n\n/**\n * Resolve the default session scope for platforms without Slack-style branch forking.\n * Top-level/private sessions use the conversation's current pointer. Threaded or\n * per-message sessions use a fixed file derived from the session key suffix.\n */\nexport function resolveGenericSessionScope(\n  options: ResolveGenericSessionScopeOptions,\n): ResolvedSessionScope {\n  const { conversationDir, sessionKey } = options;\n  const cwd = options.cwd ?? conversationDir;\n  const sessionDir = getChannelSessionDir(conversationDir);\n\n  if (!sessionKey.includes(\":\")) {\n    return {\n      sessionDir,\n      contextFile: resolveManagedSessionFile(sessionDir, cwd),\n      threadRootMessage: null,\n    };\n  }\n\n  const threadFile = getThreadSessionFile(conversationDir, sessionKey);\n  return {\n    sessionDir,\n    contextFile:\n      tryResolveThreadSession(threadFile) ?? createManagedSessionFileAtPath(threadFile, cwd),\n    threadRootMessage: null,\n  };\n}\n\nfunction hasSessionHeader(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const lines = raw.split(\"\\n\");\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      const entry = parseJsonValue(\n        trimmed,\n        (value): value is { type?: string } => isRecord(value),\n        (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n      );\n      return entry.type === \"session\";\n    }\n  } catch {\n    return false;\n  }\n  return false;\n}\n\nfunction shouldRecreatePreinitializedSession(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const entries = raw\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map((line) =>\n        parseJsonValue(\n          line,\n          (value): value is { type?: string } => isRecord(value),\n          (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n        ),\n      );\n\n    return entries.length === 1 && entries[0]?.type === \"session\";\n  } catch {\n    return false;\n  }\n}\n\nfunction getFileDir(sessionFile: string): string {\n  return sessionFile.substring(0, sessionFile.lastIndexOf(\"/\"));\n}\n\nfunction resolveThreadSnapshotEntries(\n  sourceSessionFile: string,\n  rootMessage: ThreadRootMessage,\n): SessionMessageEntryLike[] | null {\n  const targetText = buildComparableRootMessageText(rootMessage);\n  if (!targetText) return null;\n\n  const entries = SessionManager.open(sourceSessionFile).getEntries() as SessionMessageEntryLike[];\n  const matchIndex = findRootMessageIndex(entries, targetText, rootMessage.loggedAt);\n  if (matchIndex === -1) return null;\n\n  const nextTopLevelUserIndex = entries.findIndex(\n    (entry, index) => index > matchIndex && isUserMessageEntry(entry),\n  );\n  const endIndex = nextTopLevelUserIndex === -1 ? entries.length : nextTopLevelUserIndex;\n  return entries.slice(0, endIndex);\n}\n\nfunction findRootMessageIndex(\n  entries: SessionMessageEntryLike[],\n  targetText: string,\n  loggedAt?: number,\n): number {\n  for (let i = 0; i < entries.length; i++) {\n    const entry = entries[i];\n    if (!isUserMessageEntry(entry)) continue;\n\n    const comparableText = normalizeComparableUserText(getMessageText(entry));\n    if (comparableText !== targetText) continue;\n\n    const messageTimestamp = entry.message?.timestamp;\n    if (\n      loggedAt !== undefined &&\n      typeof messageTimestamp === \"number\" &&\n      messageTimestamp < loggedAt\n    ) {\n      continue;\n    }\n\n    return i;\n  }\n\n  return -1;\n}\n\nfunction isUserMessageEntry(entry: SessionMessageEntryLike): boolean {\n  return entry.type === \"message\" && entry.message?.role === \"user\";\n}\n\nfunction getMessageText(entry: SessionMessageEntryLike): string {\n  const content = entry.message?.content;\n  if (typeof content === \"string\") return content;\n  if (!Array.isArray(content)) return \"\";\n\n  return content\n    .filter((part): part is { type?: string; text?: string } => part.type === \"text\")\n    .map((part) => part.text ?? \"\")\n    .join(\"\\n\\n\");\n}\n\nfunction buildComparableRootMessageText(rootMessage: ThreadRootMessage): string | null {\n  const userLabel = rootMessage.userName || rootMessage.user || \"unknown\";\n  const text = rootMessage.text?.trim();\n  if (!text) return null;\n  return normalizeComparableUserText(`[${userLabel}]: ${text}`);\n}\n\nfunction stripSlackAttachmentBlock(text: string): string {\n  return text.replace(/\\n*<slack_attachments>\\n[\\s\\S]*?\\n<\\/slack_attachments>\\s*$/g, \"\");\n}\n\nfunction normalizeComparableUserText(text: string): string {\n  const withoutTimestamp = text.replace(\n    /^\\[[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}[+-][0-9]{2}:[0-9]{2}\\]\\s+(?=\\[[^\\]]+\\](?:\\s+\\[in-thread:[^\\]]+\\])?:\\s)/,\n    \"\",\n  );\n  return stripSlackAttachmentBlock(withoutTimestamp).trim();\n}\n\nfunction getCurrentSessionPath(sessionDir: string): string | null {\n  const pointerFile = join(sessionDir, \"current\");\n  const filename = readTextFileIfExists(pointerFile)?.trim();\n  if (!filename) return null;\n  return join(sessionDir, filename);\n}\n\n/**\n * Try to resolve an existing current session file.\n * Returns null if no current pointer exists or the pointed file has no valid session header.\n */\nexport function tryResolveCurrentSession(sessionDir: string): string | null {\n  const fullPath = getCurrentSessionPath(sessionDir);\n  if (fullPath && existsSync(fullPath) && hasSessionHeader(fullPath)) return fullPath;\n  return null;\n}\n\n/**\n * Try to resolve an existing thread session file.\n * Returns the file path if found, or null if no valid thread session exists yet.\n */\nexport function tryResolveThreadSession(sessionFile: string): string | null {\n  return existsSync(sessionFile) && hasSessionHeader(sessionFile) ? sessionFile : null;\n}\n\n/**\n * Resolve the channel's current session file path (for fork source).\n * Returns null if no channel session exists.\n */\nexport function resolveChannelSessionFile(channelDir: string): string | null {\n  return tryResolveCurrentSession(getChannelSessionDir(channelDir));\n}\n\n/**\n * Fork a channel session into a fixed thread-session path.\n * The resulting file keeps forkFrom's distinct session/header metadata.\n */\nexport function forkThreadSessionFile(\n  sourceSessionFile: string,\n  targetSessionFile: string,\n  cwd: string,\n): string {\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  const forked = SessionManager.forkFrom(sourceSessionFile, cwd, sessionDir);\n  const forkedFile = forked.getSessionFile();\n  if (!forkedFile) {\n    throw new Error(`Failed to fork session from ${sourceSessionFile}`);\n  }\n  rmSync(targetSessionFile, { force: true });\n  renameSync(forkedFile, targetSessionFile);\n  return targetSessionFile;\n}\n\nexport function createThreadSessionFileFromRootMessage(\n  targetSessionFile: string,\n  cwd: string,\n  rootMessage: ThreadRootMessage,\n  parentSession?: string,\n): string {\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  rmSync(targetSessionFile, { force: true });\n\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: randomUUID(),\n    timestamp: new Date().toISOString(),\n    cwd,\n    ...(parentSession ? { parentSession } : {}),\n  };\n  const rootText = buildComparableRootMessageText(rootMessage);\n  if (!rootText) {\n    atomicWritePrivateFile(targetSessionFile, `${JSON.stringify(header)}\\n`);\n    return targetSessionFile;\n  }\n\n  const rootEntry = {\n    type: \"message\",\n    id: randomUUID().slice(0, 8),\n    parentId: null,\n    timestamp: new Date().toISOString(),\n    message: {\n      role: \"user\",\n      content: [{ type: \"text\", text: rootText }],\n      ...(rootMessage.loggedAt !== undefined ? { timestamp: rootMessage.loggedAt } : {}),\n    },\n  };\n  const content = [header, rootEntry].map((entry) => JSON.stringify(entry)).join(\"\\n\");\n  atomicWritePrivateFile(targetSessionFile, `${content}\\n`);\n  return targetSessionFile;\n}\n\nexport function forkThreadSessionFileFromRootMessage(\n  sourceSessionFile: string,\n  targetSessionFile: string,\n  cwd: string,\n  rootMessage: ThreadRootMessage,\n): string {\n  const snapshotEntries = resolveThreadSnapshotEntries(sourceSessionFile, rootMessage);\n  if (!snapshotEntries) {\n    throw new ThreadRootNotFoundError(sourceSessionFile);\n  }\n\n  const sessionDir = getFileDir(targetSessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  rmSync(targetSessionFile, { force: true });\n\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: randomUUID(),\n    timestamp: new Date().toISOString(),\n    cwd,\n    parentSession: sourceSessionFile,\n  };\n  const content = [header, ...snapshotEntries].map((entry) => JSON.stringify(entry)).join(\"\\n\");\n  atomicWritePrivateFile(targetSessionFile, `${content}\\n`);\n  return targetSessionFile;\n}\n"]}

package/dist/store.d.ts

@@ -0,0 +1,58 @@
+export interface Attachment {
+    original: string;
+    localPath: string;
+}
+export interface LoggedMessage {
+    date: string;
+    ts: string;
+    user: string;
+    userName?: string;
+    displayName?: string;
+    text: string;
+    attachments: Attachment[];
+    isBot: boolean;
+    threadTs?: string;
+}
+export interface ChannelStoreConfig {
+    workingDir: string;
+    botToken: string;
+}
+export declare class ChannelStore {
+    private workingDir;
+    private botToken;
+    private recentlyLogged;
+    constructor(config: ChannelStoreConfig);
+    /**
+     * Get or create the directory for a channel/DM
+     */
+    getChannelDir(channelId: string): string;
+    /**
+     * Generate a unique local filename for an attachment
+     */
+    generateLocalFilename(originalName: string, timestamp: string): string;
+    /**
+     * Process attachments from a Slack message event.
+     * Downloads files before returning so callers only receive readable paths.
+     */
+    processAttachments(channelId: string, files: Array<{
+        name?: string;
+        url_private_download?: string;
+        url_private?: string;
+    }>, timestamp: string): Promise<Attachment[]>;
+    /**
+     * Log a message to the channel's log.jsonl
+     * Returns false if message was already logged (duplicate)
+     */
+    logMessage(channelId: string, message: LoggedMessage): Promise<boolean>;
+    /**
+     * Log a bot response
+     */
+    logBotResponse(channelId: string, text: string, ts: string): Promise<void>;
+    /**
+     * Get the timestamp of the last logged message for a channel
+     * Returns null if no log exists
+     */
+    getLastTimestamp(channelId: string): string | null;
+    private downloadAttachment;
+}
+//# sourceMappingURL=store.d.ts.map