@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.90

package/dist/migrations/sessions-v3.d.ts

@@ -0,0 +1,8 @@
+import type { Migration } from "./types.js";
+export declare function isV3SessionFile(filePath: string): boolean;
+export declare function migrateSessionFile(filePath: string, options?: {
+    dryRun?: boolean;
+}): Promise<void>;
+export declare function findV3SessionFiles(root: string): string[];
+export declare const sessionsV3Migration: Migration;
+//# sourceMappingURL=sessions-v3.d.ts.map

package/dist/migrations/sessions-v3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-v3.d.ts","sourceRoot":"","sources":["../../src/migrations/sessions-v3.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAmE9D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUzD;AA4UD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,eAAO,MAAM,mBAAmB,EAAE,SAShC,CAAC"}

package/dist/migrations/sessions-v3.js

@@ -0,0 +1,350 @@
+import { readFileSync } from "node:fs";
+import { branchSummaryMessage as createBranchSummaryMessage, buildV4Context, compactionSummaryMessage as createCompactionSummaryMessage, customMessage as createCustomMessage, readV4Session, } from "./session-v4.js";
+import { commitMigration, findSessionFiles, optionalAnnotations, V4FileWriter, } from "./session-files.js";
+function isFactEntry(entry) {
+    return entry.type === "session_info" || entry.type === "label" || entry.type === "leaf";
+}
+export function isV3SessionFile(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const firstLine = content.split("\n").find((line) => line.trim().length > 0);
+        if (!firstLine)
+            return false;
+        const parsed = JSON.parse(firstLine);
+        return parsed.type === "session";
+    }
+    catch {
+        return false;
+    }
+}
+function parseJsonLines(filePath) {
+    const lines = readFileSync(filePath, "utf-8")
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    const records = [];
+    for (const [index, line] of lines.entries()) {
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch (error) {
+            if (index === lines.length - 1 && index > 0)
+                continue;
+            throw new Error(`Invalid JSON on line ${index + 1} of ${filePath}`, { cause: error });
+        }
+    }
+    return records;
+}
+function dedupeEntries(records) {
+    const entriesById = new Map();
+    for (const record of records) {
+        if (typeof record.type !== "string" || typeof record.id !== "string")
+            continue;
+        if (record.type === "session")
+            continue;
+        entriesById.set(record.id, record);
+    }
+    return [...entriesById.values()];
+}
+function readV3SessionFile(filePath) {
+    const records = parseJsonLines(filePath);
+    const header = records[0];
+    if (!header || header.type !== "session" || typeof header.id !== "string") {
+        throw new Error(`Not a v3 session file: ${filePath}`);
+    }
+    return {
+        header: header,
+        entries: dedupeEntries(records.slice(1)),
+    };
+}
+function toEpochMillis(timestamp) {
+    const parsed = Date.parse(timestamp);
+    return Number.isNaN(parsed) ? 0 : parsed;
+}
+function v3Branch(entries, fromId) {
+    const byId = new Map(entries.map((entry) => [entry.id, entry]));
+    const path = [];
+    let currentId = fromId;
+    while (currentId) {
+        const entry = byId.get(currentId);
+        if (!entry)
+            break;
+        path.push(entry);
+        currentId = entry.parentId;
+    }
+    return path.toReversed();
+}
+function v3LeafId(entries) {
+    let leafId = null;
+    for (const entry of entries) {
+        leafId = entry.type === "leaf" ? entry.targetId : entry.id;
+    }
+    return leafId;
+}
+function customMessageOf(entry) {
+    return createCustomMessage(entry.customType, entry.content, entry.display, entry.details, toEpochMillis(entry.timestamp));
+}
+function convertEntry(entry, entries) {
+    const base = {
+        id: entry.id,
+        parentId: resolveV4Parent(entry, entries),
+        timestamp: toEpochMillis(entry.timestamp),
+    };
+    switch (entry.type) {
+        case "message":
+            return { ...base, type: "message", message: entry.message };
+        case "custom_message":
+            return { ...base, type: "message", message: customMessageOf(entry) };
+        case "thinking_level_change":
+        case "model_change":
+        case "active_tools_change": {
+            const { id: _id, parentId: _parentId, timestamp: _timestamp, type, ...data } = entry;
+            return {
+                ...base,
+                type: "custom",
+                customType: `mikan.legacy.${type}`,
+                data: data,
+            };
+        }
+        case "compaction":
+            return {
+                ...base,
+                type: "compaction",
+                summary: entry.summary,
+                retainedTail: entry.retainedTail ?? compactionKeptMessages(entry, entries),
+                tokensBefore: entry.tokensBefore,
+                ...optionalAnnotations(entry),
+            };
+        case "branch_summary":
+            return {
+                ...base,
+                type: "branch_summary",
+                fromId: entry.fromId ?? null,
+                summary: entry.summary,
+                ...optionalAnnotations(entry),
+            };
+        case "custom":
+            return {
+                ...base,
+                type: "custom",
+                customType: entry.customType,
+                data: entry.data,
+            };
+        default:
+            return null;
+    }
+}
+function resolveV4Parent(entry, entries) {
+    const byId = new Map(entries.map((item) => [item.id, item]));
+    let parentId = entry.parentId;
+    while (parentId !== null) {
+        const parent = byId.get(parentId);
+        if (!parent)
+            return null;
+        if (!isFactEntry(parent))
+            return parentId;
+        parentId = parent.parentId;
+    }
+    return null;
+}
+function compactionKeptMessages(compaction, entries) {
+    if (!compaction.firstKeptEntryId)
+        return [];
+    const ancestors = v3Branch(entries, compaction.parentId);
+    const keptStart = ancestors.findIndex((entry) => entry.id === compaction.firstKeptEntryId);
+    if (keptStart === -1)
+        return [];
+    const messages = [];
+    for (const entry of ancestors.slice(keptStart)) {
+        if (entry.type === "message")
+            messages.push(entry.message);
+        else if (entry.type === "custom_message")
+            messages.push(customMessageOf(entry));
+    }
+    return messages;
+}
+function orderForReference(branch) {
+    const lastIndex = branch.findLastIndex((entry) => entry.type === "compaction");
+    const lastCompaction = branch[lastIndex];
+    const firstKeptId = lastCompaction?.retainedTail ? undefined : lastCompaction?.firstKeptEntryId;
+    const firstKeptIndex = firstKeptId === undefined ? -1 : branch.findIndex((entry) => entry.id === firstKeptId);
+    if (firstKeptIndex === -1 || !lastCompaction)
+        return { ordered: branch };
+    return {
+        ordered: [
+            ...branch.slice(0, firstKeptIndex),
+            lastCompaction,
+            ...branch.filter((_, index) => index >= firstKeptIndex && index !== lastIndex),
+        ],
+        repositioned: lastCompaction,
+    };
+}
+function emptiedCompaction(entry) {
+    return {
+        type: "compaction",
+        id: entry.id,
+        parentId: null,
+        timestamp: toEpochMillis(entry.timestamp),
+        summary: entry.summary,
+        retainedTail: [],
+        tokensBefore: entry.tokensBefore,
+    };
+}
+function referenceContextEntries(branch) {
+    const { ordered, repositioned } = orderForReference(branch);
+    const converted = [];
+    for (const entry of ordered) {
+        const piEntry = repositioned === entry ? emptiedCompaction(repositioned) : convertEntry(entry, []);
+        if (piEntry)
+            converted.push(piEntry);
+    }
+    let previousId = null;
+    for (const entry of converted) {
+        entry.parentId = previousId;
+        previousId = entry.id;
+    }
+    return converted;
+}
+function isCurrentContextMessage(message) {
+    return (message.role !== "assistant" ||
+        (message.stopReason !== "error" &&
+            message.stopReason !== "aborted" &&
+            message.stopReason !== "deferred"));
+}
+function contextMessagesOf(entry) {
+    if (entry.type === "message") {
+        return isCurrentContextMessage(entry.message) ? [entry.message] : [];
+    }
+    if (entry.type === "compaction") {
+        return [
+            createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),
+            ...entry.retainedTail.filter(isCurrentContextMessage),
+        ];
+    }
+    if (entry.type === "branch_summary" && entry.summary) {
+        return [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];
+    }
+    return [];
+}
+function referenceContextMessages(entries) {
+    const compactionIndex = entries.findLastIndex((entry) => entry.type === "compaction");
+    const visible = compactionIndex === -1 ? entries : entries.slice(compactionIndex);
+    return visible.flatMap(contextMessagesOf);
+}
+function buildV4Header(header) {
+    return {
+        v: 4,
+        kind: "header",
+        id: header.id,
+        storageVersion: 1,
+        createdAt: toEpochMillis(header.timestamp),
+        cwd: header.cwd,
+        parentSessionId: header.parentSessionId,
+    };
+}
+function partitionEntries(entries) {
+    const tree = [];
+    const labels = [];
+    let name;
+    for (const entry of entries) {
+        switch (entry.type) {
+            case "session_info":
+                name = entry.name?.trim() || undefined;
+                break;
+            case "label":
+                labels.push({ targetId: entry.targetId, label: entry.label });
+                break;
+            case "leaf":
+                break;
+            default:
+                tree.push(entry);
+        }
+    }
+    return { tree, name, labels };
+}
+function resolveV4Leaf(entries) {
+    const byId = new Map(entries.map((entry) => [entry.id, entry]));
+    let leafId = v3LeafId(entries);
+    while (leafId !== null) {
+        const target = byId.get(leafId);
+        if (!target)
+            return null;
+        if (!isFactEntry(target))
+            return leafId;
+        leafId = target.parentId;
+    }
+    return null;
+}
+function headerMetadata(header) {
+    const { type: _type, version: _version, id: _id, timestamp: _timestamp, cwd: _cwd, parentSession: _parentSession, parentSessionId: _parentSessionId, ...extras } = header;
+    const metadata = extras;
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+function encodeV4File(file) {
+    const writer = new V4FileWriter(buildV4Header(file.header));
+    const { tree, name, labels } = partitionEntries(file.entries);
+    for (const entry of tree) {
+        const converted = convertEntry(entry, file.entries);
+        if (converted)
+            writer.entry(converted);
+    }
+    writer.set("pi.branch.tip", "main", resolveV4Leaf(file.entries));
+    if (name !== undefined)
+        writer.set("pi.session.name", "", name);
+    for (const { targetId, label } of labels) {
+        if (label !== undefined)
+            writer.set("pi.entry.label", targetId, label);
+    }
+    const metadata = headerMetadata(file.header);
+    if (metadata)
+        writer.set("mikan", "metadata", metadata);
+    return writer.toString();
+}
+async function verifyMigratedFile(v4Path, source) {
+    const migratedSession = readV4Session(v4Path);
+    const migratedContext = { messages: buildV4Context(migratedSession.branch) };
+    const branch = v3Branch(source.entries, v3LeafId(source.entries));
+    const migrated = JSON.stringify(migratedContext.messages);
+    const reference = JSON.stringify(referenceContextMessages(referenceContextEntries(branch)));
+    if (migrated !== reference) {
+        throw new Error("migrated context does not match the v3 reference context");
+    }
+    const migratedName = migratedSession.name;
+    const v3Name = [...source.entries]
+        .toReversed()
+        .find((entry) => entry.type === "session_info")
+        ?.name?.trim();
+    if ((migratedName ?? "") !== (v3Name || "")) {
+        throw new Error("migrated session name does not match the v3 session name");
+    }
+}
+export async function migrateSessionFile(filePath, options) {
+    if (!isV3SessionFile(filePath))
+        return;
+    const sourceBytes = readFileSync(filePath);
+    const source = readV3SessionFile(filePath);
+    if (options?.dryRun)
+        return;
+    await commitMigration({
+        filePath,
+        sourceBytes,
+        encoded: encodeV4File(source),
+        tempPath: `${filePath}.v4.tmp`,
+        backupPath: `${filePath}.v3.bak`,
+        verify: (candidatePath) => verifyMigratedFile(candidatePath, source),
+    });
+}
+export function findV3SessionFiles(root) {
+    return findSessionFiles(root, isV3SessionFile);
+}
+export const sessionsV3Migration = Object.freeze({
+    id: "0004-sessions-v3",
+    summary: "convert v3 session files to the current Pi session format, keeping *.v3.bak",
+    async run(context) {
+        for (const file of findV3SessionFiles(context.workspaceRoot)) {
+            context.report(`  session ${file}`);
+            await migrateSessionFile(file, { dryRun: context.dryRun });
+        }
+    },
+});
+//# sourceMappingURL=sessions-v3.js.map

package/dist/migrations/sessions-v3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-v3.js","sourceRoot":"","sources":["../../src/migrations/sessions-v3.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { JsonValue } from \"@earendil-works/chord\";\nimport {\n  branchSummaryMessage as createBranchSummaryMessage,\n  buildV4Context,\n  compactionSummaryMessage as createCompactionSummaryMessage,\n  customMessage as createCustomMessage,\n  readV4Session,\n  type V4Entry as PiEntry,\n  type V4Message as AgentMessage,\n} from \"./session-v4.js\";\nimport {\n  commitMigration,\n  findSessionFiles,\n  optionalAnnotations,\n  V4FileWriter,\n} from \"./session-files.js\";\nimport type { Migration, MigrationContext } from \"./types.js\";\n\ninterface V3EntryBase {\n  type: string;\n  id: string;\n  parentId: string | null;\n  timestamp: string;\n}\n\ntype V3Entry = V3EntryBase &\n  (\n    | { type: \"message\"; message: AgentMessage }\n    | { type: \"thinking_level_change\"; thinkingLevel: string }\n    | { type: \"model_change\"; provider: string; modelId: string }\n    | { type: \"active_tools_change\"; activeToolNames: string[] }\n    | {\n        type: \"compaction\";\n        summary: string;\n        firstKeptEntryId?: string;\n        tokensBefore: number;\n        retainedTail?: AgentMessage[];\n        details?: unknown;\n        usage?: unknown;\n      }\n    | {\n        type: \"branch_summary\";\n        fromId: string;\n        summary: string;\n        details?: unknown;\n        usage?: unknown;\n      }\n    | { type: \"custom\"; customType: string; data?: unknown }\n    | {\n        type: \"custom_message\";\n        customType: string;\n        content: Parameters<typeof createCustomMessage>[1];\n        display: boolean;\n        details?: unknown;\n      }\n    | { type: \"label\"; targetId: string; label: string | undefined }\n    | { type: \"session_info\"; name?: string }\n    | { type: \"leaf\"; targetId: string | null }\n  );\n\ntype V3Compaction = Extract<V3Entry, { type: \"compaction\" }>;\ntype V3CustomMessage = Extract<V3Entry, { type: \"custom_message\" }>;\n\ninterface V3SessionHeader {\n  type: \"session\";\n  version?: number;\n  id: string;\n  timestamp: string;\n  cwd: string;\n  parentSession?: string;\n  parentSessionId?: string;\n  [extra: string]: unknown;\n}\n\ninterface V3SessionFile {\n  header: V3SessionHeader;\n  entries: V3Entry[];\n}\n\nfunction isFactEntry(entry: V3Entry): boolean {\n  return entry.type === \"session_info\" || entry.type === \"label\" || entry.type === \"leaf\";\n}\n\nexport function isV3SessionFile(filePath: string): boolean {\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    const firstLine = content.split(\"\\n\").find((line) => line.trim().length > 0);\n    if (!firstLine) return false;\n    const parsed = JSON.parse(firstLine) as { type?: unknown };\n    return parsed.type === \"session\";\n  } catch {\n    return false;\n  }\n}\n\nfunction parseJsonLines(filePath: string): Record<string, unknown>[] {\n  const lines = readFileSync(filePath, \"utf-8\")\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n  const records: Record<string, unknown>[] = [];\n  for (const [index, line] of lines.entries()) {\n    try {\n      records.push(JSON.parse(line) as Record<string, unknown>);\n    } catch (error) {\n      if (index === lines.length - 1 && index > 0) continue;\n      throw new Error(`Invalid JSON on line ${index + 1} of ${filePath}`, { cause: error });\n    }\n  }\n  return records;\n}\n\nfunction dedupeEntries(records: Record<string, unknown>[]): V3Entry[] {\n  const entriesById = new Map<string, V3Entry>();\n  for (const record of records) {\n    if (typeof record.type !== \"string\" || typeof record.id !== \"string\") continue;\n    if (record.type === \"session\") continue;\n    entriesById.set(record.id, record as unknown as V3Entry);\n  }\n  return [...entriesById.values()];\n}\n\nfunction readV3SessionFile(filePath: string): V3SessionFile {\n  const records = parseJsonLines(filePath);\n  const header = records[0];\n  if (!header || header.type !== \"session\" || typeof header.id !== \"string\") {\n    throw new Error(`Not a v3 session file: ${filePath}`);\n  }\n  return {\n    header: header as unknown as V3SessionHeader,\n    entries: dedupeEntries(records.slice(1)),\n  };\n}\n\nfunction toEpochMillis(timestamp: string): number {\n  const parsed = Date.parse(timestamp);\n  return Number.isNaN(parsed) ? 0 : parsed;\n}\n\nfunction v3Branch(entries: V3Entry[], fromId: string | null): V3Entry[] {\n  const byId = new Map(entries.map((entry) => [entry.id, entry]));\n  const path: V3Entry[] = [];\n  let currentId = fromId;\n  while (currentId) {\n    const entry = byId.get(currentId);\n    if (!entry) break;\n    path.push(entry);\n    currentId = entry.parentId;\n  }\n  return path.toReversed();\n}\n\nfunction v3LeafId(entries: V3Entry[]): string | null {\n  let leafId: string | null = null;\n  for (const entry of entries) {\n    leafId = entry.type === \"leaf\" ? entry.targetId : entry.id;\n  }\n  return leafId;\n}\n\nfunction customMessageOf(entry: V3CustomMessage): AgentMessage {\n  return createCustomMessage(\n    entry.customType,\n    entry.content,\n    entry.display,\n    entry.details,\n    toEpochMillis(entry.timestamp),\n  );\n}\n\nfunction convertEntry(entry: V3Entry, entries: V3Entry[]): PiEntry | null {\n  const base = {\n    id: entry.id,\n    parentId: resolveV4Parent(entry, entries),\n    timestamp: toEpochMillis(entry.timestamp),\n  };\n  switch (entry.type) {\n    case \"message\":\n      return { ...base, type: \"message\", message: entry.message };\n    case \"custom_message\":\n      return { ...base, type: \"message\", message: customMessageOf(entry) };\n    case \"thinking_level_change\":\n    case \"model_change\":\n    case \"active_tools_change\": {\n      const { id: _id, parentId: _parentId, timestamp: _timestamp, type, ...data } = entry;\n      return {\n        ...base,\n        type: \"custom\",\n        customType: `mikan.legacy.${type}`,\n        data: data as JsonValue,\n      };\n    }\n    case \"compaction\":\n      return {\n        ...base,\n        type: \"compaction\",\n        summary: entry.summary,\n        retainedTail: entry.retainedTail ?? compactionKeptMessages(entry, entries),\n        tokensBefore: entry.tokensBefore,\n        ...optionalAnnotations(entry),\n      } as unknown as PiEntry;\n    case \"branch_summary\":\n      return {\n        ...base,\n        type: \"branch_summary\",\n        fromId: entry.fromId ?? null,\n        summary: entry.summary,\n        ...optionalAnnotations(entry),\n      } as unknown as PiEntry;\n    case \"custom\":\n      return {\n        ...base,\n        type: \"custom\",\n        customType: entry.customType,\n        data: entry.data as JsonValue | undefined,\n      };\n    default:\n      return null;\n  }\n}\n\nfunction resolveV4Parent(entry: V3Entry, entries: V3Entry[]): string | null {\n  const byId = new Map(entries.map((item) => [item.id, item]));\n  let parentId = entry.parentId;\n  while (parentId !== null) {\n    const parent = byId.get(parentId);\n    if (!parent) return null;\n    if (!isFactEntry(parent)) return parentId;\n    parentId = parent.parentId;\n  }\n  return null;\n}\n\nfunction compactionKeptMessages(compaction: V3Compaction, entries: V3Entry[]): AgentMessage[] {\n  if (!compaction.firstKeptEntryId) return [];\n  const ancestors = v3Branch(entries, compaction.parentId);\n  const keptStart = ancestors.findIndex((entry) => entry.id === compaction.firstKeptEntryId);\n  if (keptStart === -1) return [];\n  const messages: AgentMessage[] = [];\n  for (const entry of ancestors.slice(keptStart)) {\n    if (entry.type === \"message\") messages.push(entry.message);\n    else if (entry.type === \"custom_message\") messages.push(customMessageOf(entry));\n  }\n  return messages;\n}\n\nfunction orderForReference(branch: V3Entry[]): {\n  ordered: V3Entry[];\n  repositioned?: V3Compaction;\n} {\n  const lastIndex = branch.findLastIndex((entry) => entry.type === \"compaction\");\n  const lastCompaction = branch[lastIndex] as V3Compaction | undefined;\n  const firstKeptId = lastCompaction?.retainedTail ? undefined : lastCompaction?.firstKeptEntryId;\n  const firstKeptIndex =\n    firstKeptId === undefined ? -1 : branch.findIndex((entry) => entry.id === firstKeptId);\n  if (firstKeptIndex === -1 || !lastCompaction) return { ordered: branch };\n  return {\n    ordered: [\n      ...branch.slice(0, firstKeptIndex),\n      lastCompaction,\n      ...branch.filter((_, index) => index >= firstKeptIndex && index !== lastIndex),\n    ],\n    repositioned: lastCompaction,\n  };\n}\n\nfunction emptiedCompaction(entry: V3Compaction): PiEntry {\n  return {\n    type: \"compaction\",\n    id: entry.id,\n    parentId: null,\n    timestamp: toEpochMillis(entry.timestamp),\n    summary: entry.summary,\n    retainedTail: [],\n    tokensBefore: entry.tokensBefore,\n  };\n}\n\nfunction referenceContextEntries(branch: V3Entry[]): PiEntry[] {\n  const { ordered, repositioned } = orderForReference(branch);\n  const converted: PiEntry[] = [];\n  for (const entry of ordered) {\n    const piEntry =\n      repositioned === entry ? emptiedCompaction(repositioned) : convertEntry(entry, []);\n    if (piEntry) converted.push(piEntry);\n  }\n  let previousId: string | null = null;\n  for (const entry of converted) {\n    entry.parentId = previousId;\n    previousId = entry.id;\n  }\n  return converted;\n}\n\nfunction isCurrentContextMessage(message: AgentMessage): boolean {\n  return (\n    message.role !== \"assistant\" ||\n    (message.stopReason !== \"error\" &&\n      message.stopReason !== \"aborted\" &&\n      message.stopReason !== \"deferred\")\n  );\n}\n\nfunction contextMessagesOf(entry: PiEntry): AgentMessage[] {\n  if (entry.type === \"message\") {\n    return isCurrentContextMessage(entry.message) ? [entry.message] : [];\n  }\n  if (entry.type === \"compaction\") {\n    return [\n      createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),\n      ...entry.retainedTail.filter(isCurrentContextMessage),\n    ];\n  }\n  if (entry.type === \"branch_summary\" && entry.summary) {\n    return [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];\n  }\n  return [];\n}\n\nfunction referenceContextMessages(entries: PiEntry[]): AgentMessage[] {\n  const compactionIndex = entries.findLastIndex((entry) => entry.type === \"compaction\");\n  const visible = compactionIndex === -1 ? entries : entries.slice(compactionIndex);\n  return visible.flatMap(contextMessagesOf);\n}\n\nfunction buildV4Header(header: V3SessionHeader): Record<string, unknown> {\n  return {\n    v: 4,\n    kind: \"header\",\n    id: header.id,\n    storageVersion: 1,\n    createdAt: toEpochMillis(header.timestamp),\n    cwd: header.cwd,\n    parentSessionId: header.parentSessionId,\n  };\n}\n\nfunction partitionEntries(entries: V3Entry[]): {\n  tree: V3Entry[];\n  name?: string;\n  labels: Array<{ targetId: string; label: string | undefined }>;\n} {\n  const tree: V3Entry[] = [];\n  const labels: Array<{ targetId: string; label: string | undefined }> = [];\n  let name: string | undefined;\n  for (const entry of entries) {\n    switch (entry.type) {\n      case \"session_info\":\n        name = entry.name?.trim() || undefined;\n        break;\n      case \"label\":\n        labels.push({ targetId: entry.targetId, label: entry.label });\n        break;\n      case \"leaf\":\n        break;\n      default:\n        tree.push(entry);\n    }\n  }\n  return { tree, name, labels };\n}\n\nfunction resolveV4Leaf(entries: V3Entry[]): string | null {\n  const byId = new Map(entries.map((entry) => [entry.id, entry]));\n  let leafId = v3LeafId(entries);\n  while (leafId !== null) {\n    const target = byId.get(leafId);\n    if (!target) return null;\n    if (!isFactEntry(target)) return leafId;\n    leafId = target.parentId;\n  }\n  return null;\n}\n\nfunction headerMetadata(header: V3SessionHeader): Record<string, JsonValue> | undefined {\n  const {\n    type: _type,\n    version: _version,\n    id: _id,\n    timestamp: _timestamp,\n    cwd: _cwd,\n    parentSession: _parentSession,\n    parentSessionId: _parentSessionId,\n    ...extras\n  } = header;\n  const metadata: Record<string, JsonValue> = extras as Record<string, JsonValue>;\n  return Object.keys(metadata).length > 0 ? metadata : undefined;\n}\n\nfunction encodeV4File(file: V3SessionFile): string {\n  const writer = new V4FileWriter(buildV4Header(file.header));\n  const { tree, name, labels } = partitionEntries(file.entries);\n  for (const entry of tree) {\n    const converted = convertEntry(entry, file.entries);\n    if (converted) writer.entry(converted);\n  }\n  writer.set(\"pi.branch.tip\", \"main\", resolveV4Leaf(file.entries));\n  if (name !== undefined) writer.set(\"pi.session.name\", \"\", name);\n  for (const { targetId, label } of labels) {\n    if (label !== undefined) writer.set(\"pi.entry.label\", targetId, label);\n  }\n  const metadata = headerMetadata(file.header);\n  if (metadata) writer.set(\"mikan\", \"metadata\", metadata);\n  return writer.toString();\n}\n\nasync function verifyMigratedFile(v4Path: string, source: V3SessionFile): Promise<void> {\n  const migratedSession = readV4Session(v4Path);\n  const migratedContext = { messages: buildV4Context(migratedSession.branch) };\n  const branch = v3Branch(source.entries, v3LeafId(source.entries));\n  const migrated = JSON.stringify(migratedContext.messages);\n  const reference = JSON.stringify(referenceContextMessages(referenceContextEntries(branch)));\n  if (migrated !== reference) {\n    throw new Error(\"migrated context does not match the v3 reference context\");\n  }\n  const migratedName = migratedSession.name;\n  const v3Name = [...source.entries]\n    .toReversed()\n    .find((entry) => entry.type === \"session_info\")\n    ?.name?.trim();\n  if ((migratedName ?? \"\") !== (v3Name || \"\")) {\n    throw new Error(\"migrated session name does not match the v3 session name\");\n  }\n}\n\nexport async function migrateSessionFile(\n  filePath: string,\n  options?: { dryRun?: boolean },\n): Promise<void> {\n  if (!isV3SessionFile(filePath)) return;\n  const sourceBytes = readFileSync(filePath);\n  const source = readV3SessionFile(filePath);\n  if (options?.dryRun) return;\n\n  await commitMigration({\n    filePath,\n    sourceBytes,\n    encoded: encodeV4File(source),\n    tempPath: `${filePath}.v4.tmp`,\n    backupPath: `${filePath}.v3.bak`,\n    verify: (candidatePath) => verifyMigratedFile(candidatePath, source),\n  });\n}\n\nexport function findV3SessionFiles(root: string): string[] {\n  return findSessionFiles(root, isV3SessionFile);\n}\n\nexport const sessionsV3Migration: Migration = Object.freeze({\n  id: \"0004-sessions-v3\",\n  summary: \"convert v3 session files to the current Pi session format, keeping *.v3.bak\",\n  async run(context: MigrationContext): Promise<void> {\n    for (const file of findV3SessionFiles(context.workspaceRoot)) {\n      context.report(`  session ${file}`);\n      await migrateSessionFile(file, { dryRun: context.dryRun });\n    }\n  },\n});\n"]}

package/dist/migrations/types.d.ts

@@ -0,0 +1,25 @@
+import type { SandboxConfig } from "../sandbox/types.js";
+import type { PlatformName } from "../types.js";
+export type DockerCli = (args: readonly string[]) => Promise<string>;
+export interface MigrationContext {
+    readonly workspaceRoot: string;
+    readonly stateDir: string;
+    readonly dryRun: boolean;
+    readonly owners: ReadonlyMap<string, PlatformName>;
+    readonly enabledPlatforms: readonly PlatformName[];
+    readonly sandbox: SandboxConfig;
+    readonly piAgentDir: string;
+    readonly modelsPath: string;
+    readonly docker: DockerCli;
+    report(line: string): void;
+}
+export interface Migration {
+    readonly id: string;
+    readonly summary: string;
+    run(context: MigrationContext): Promise<void>;
+}
+export interface AppliedMigration {
+    readonly id: string;
+    readonly appliedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/migrations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/migrations/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/migrations/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/migrations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/migrations/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { SandboxConfig } from \"../sandbox/types.js\";\nimport type { PlatformName } from \"../types.js\";\n\nexport type DockerCli = (args: readonly string[]) => Promise<string>;\n\nexport interface MigrationContext {\n  readonly workspaceRoot: string;\n  readonly stateDir: string;\n  readonly dryRun: boolean;\n  readonly owners: ReadonlyMap<string, PlatformName>;\n  readonly enabledPlatforms: readonly PlatformName[];\n  readonly sandbox: SandboxConfig;\n  readonly piAgentDir: string;\n  readonly modelsPath: string;\n  readonly docker: DockerCli;\n  report(line: string): void;\n}\n\nexport interface Migration {\n  readonly id: string;\n  readonly summary: string;\n  run(context: MigrationContext): Promise<void>;\n}\n\nexport interface AppliedMigration {\n  readonly id: string;\n  readonly appliedAt: string;\n}\n"]}

package/dist/migrations/workspace-events.d.ts

@@ -0,0 +1,3 @@
+import type { Migration } from "./types.js";
+export declare const workspaceEventsMigration: Migration;
+//# sourceMappingURL=workspace-events.d.ts.map

package/dist/migrations/workspace-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-events.d.ts","sourceRoot":"","sources":["../../src/migrations/workspace-events.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AAU9D,eAAO,MAAM,wBAAwB,EAAE,SAyBrC,CAAC"}

package/dist/migrations/workspace-events.js

@@ -0,0 +1,43 @@
+import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmdirSync, rmSync, } from "node:fs";
+import { join } from "node:path";
+import { officeEventsDir, parseEventPayload } from "../events/index.js";
+import { atomicWritePrivateFile } from "../file-guards.js";
+import { assertPlatformName, createOfficeAddress, createWorkspace } from "../office/index.js";
+function eventAddress(source, filename) {
+    const payload = parseEventPayload(readFileSync(source, "utf-8"), filename);
+    if (!payload.platform) {
+        throw new Error(`Event has no platform, so its conversation is unknown: ${source}`);
+    }
+    return createOfficeAddress(assertPlatformName(payload.platform), payload.conversationId);
+}
+export const workspaceEventsMigration = Object.freeze({
+    id: "0005-workspace-events",
+    summary: "move scheduled events from <workspace>/events into each office's host state",
+    async run(context) {
+        const legacyDir = join(context.workspaceRoot, "events");
+        if (!existsSync(legacyDir))
+            return;
+        const workspace = createWorkspace({ root: context.workspaceRoot, stateDir: context.stateDir });
+        const filenames = readdirSync(legacyDir)
+            .filter((name) => name.endsWith(".json") && lstatSync(join(legacyDir, name)).isFile())
+            .toSorted();
+        for (const filename of filenames) {
+            const source = join(legacyDir, filename);
+            const office = workspace.office(eventAddress(source, filename));
+            const targetDir = officeEventsDir(office);
+            const target = join(targetDir, filename);
+            if (existsSync(target))
+                throw new Error(`Event already exists in its office: ${target}`);
+            context.report(`  event ${filename} -> ${office.key}`);
+            if (context.dryRun)
+                continue;
+            office.ensure();
+            mkdirSync(targetDir, { recursive: true, mode: 0o700 });
+            atomicWritePrivateFile(target, readFileSync(source, "utf-8"));
+            rmSync(source);
+        }
+        if (!context.dryRun && readdirSync(legacyDir).length === 0)
+            rmdirSync(legacyDir);
+    },
+});
+//# sourceMappingURL=workspace-events.js.map

package/dist/migrations/workspace-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-events.js","sourceRoot":"","sources":["../../src/migrations/workspace-events.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  existsSync,\n  lstatSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  rmdirSync,\n  rmSync,\n} from \"node:fs\";\nimport { join } from \"node:path\";\nimport { officeEventsDir, parseEventPayload } from \"../events/index.js\";\nimport { atomicWritePrivateFile } from \"../file-guards.js\";\nimport { assertPlatformName, createOfficeAddress, createWorkspace } from \"../office/index.js\";\nimport type { OfficeAddress } from \"../types.js\";\nimport type { Migration, MigrationContext } from \"./types.js\";\n\nfunction eventAddress(source: string, filename: string): OfficeAddress {\n  const payload = parseEventPayload(readFileSync(source, \"utf-8\"), filename);\n  if (!payload.platform) {\n    throw new Error(`Event has no platform, so its conversation is unknown: ${source}`);\n  }\n  return createOfficeAddress(assertPlatformName(payload.platform), payload.conversationId);\n}\n\nexport const workspaceEventsMigration: Migration = Object.freeze({\n  id: \"0005-workspace-events\",\n  summary: \"move scheduled events from <workspace>/events into each office's host state\",\n  async run(context: MigrationContext): Promise<void> {\n    const legacyDir = join(context.workspaceRoot, \"events\");\n    if (!existsSync(legacyDir)) return;\n    const workspace = createWorkspace({ root: context.workspaceRoot, stateDir: context.stateDir });\n    const filenames = readdirSync(legacyDir)\n      .filter((name) => name.endsWith(\".json\") && lstatSync(join(legacyDir, name)).isFile())\n      .toSorted();\n    for (const filename of filenames) {\n      const source = join(legacyDir, filename);\n      const office = workspace.office(eventAddress(source, filename));\n      const targetDir = officeEventsDir(office);\n      const target = join(targetDir, filename);\n      if (existsSync(target)) throw new Error(`Event already exists in its office: ${target}`);\n      context.report(`  event ${filename} -> ${office.key}`);\n      if (context.dryRun) continue;\n      office.ensure();\n      mkdirSync(targetDir, { recursive: true, mode: 0o700 });\n      atomicWritePrivateFile(target, readFileSync(source, \"utf-8\"));\n      rmSync(source);\n    }\n    if (!context.dryRun && readdirSync(legacyDir).length === 0) rmdirSync(legacyDir);\n  },\n});\n"]}

package/dist/observability/index.d.ts

@@ -0,0 +1,30 @@
+import type { JevOutcomeReport, ObservabilityAttributes, ReportUserFacingErrorOptions, RunScopeContext, SubagentOutcomeReport } from "./types.js";
+export interface ObservabilitySpan {
+    end(options?: {
+        attributes?: ObservabilityAttributes;
+        error?: unknown;
+    }): void;
+}
+export declare function metricAttributes(attributes: Record<string, string | number | boolean | undefined>): ObservabilityAttributes;
+export declare function recordCounter(name: string, value: number, attributes?: ObservabilityAttributes): void;
+export declare function recordDistribution(name: string, value: number, options?: {
+    unit?: string;
+    attributes?: ObservabilityAttributes;
+}): void;
+export declare function recordGauge(name: string, value: number, options?: {
+    unit?: string;
+    attributes?: ObservabilityAttributes;
+}): void;
+export declare function createRunAttributionAttributes(context: RunScopeContext): ObservabilityAttributes;
+export declare function withRunSpan<T>(context: RunScopeContext, body: () => Promise<T>): Promise<T>;
+export declare function startOperationSpan(name: string, attributes?: ObservabilityAttributes): ObservabilitySpan;
+export declare function updateActiveSpanAttribution(attributes: ObservabilityAttributes): void;
+export declare function addLifecycleEvent(name: string, attributes?: Record<string, string | number | boolean | undefined>): void;
+export declare function recordDiagnosticEvent(name: string, data: Record<string, unknown>): void;
+export declare function reportUserFacingError(error: unknown, options: ReportUserFacingErrorOptions): string | undefined;
+export declare function captureError(error: unknown): string | undefined;
+export declare function shutdownObservability(timeoutMs: number): Promise<boolean>;
+export declare function recordSubagentOutcome(report: SubagentOutcomeReport): string | undefined;
+export declare function reportSubagentLaunchError(error: unknown, report: Pick<SubagentOutcomeReport, "itemId" | "mode" | "profile">): string | undefined;
+export declare function recordJevOutcome(report: JevOutcomeReport): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,4BAA4B,EAC5B,eAAe,EACf,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,uBAAuB,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAChF;AAaD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAChE,uBAAuB,CAYzB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,uBAA4B,GACvC,IAAI,CAYN;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;CAAO,GACpE,IAAI,CAgBN;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;CAAO,GACpE,IAAI,CAgBN;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,eAAe,GAAG,uBAAuB,CAShG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAcjG;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,uBAA4B,GACvC,iBAAiB,CAiBnB;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAErF;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GACjE,IAAI,CAIN;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAwBvF;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,4BAA4B,GACpC,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAO/D;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB/E;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAuDvF;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC,GACjE,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAqB/D"}