@supersession/sup 0.1.1

package/dist/import.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `sup import` sources: a local export file, pasted text/JSON, or a share URL.
+ *
+ * Reliability ladder (honest by design):
+ *  - FILE / STDIN: fully reliable. The official export JSON is a stable contract.
+ *  - URL: best-effort. Modern share pages (ChatGPT especially) render via a JS
+ *    data loader, so a plain fetch often only sees a shell. We try to extract an
+ *    embedded conversation payload from the server HTML; if we can't, we say so
+ *    clearly and point at the reliable export-file path — we never pretend.
+ */
+import type { NsfSession } from "./nsf.js";
+export declare class ImportError extends Error {
+}
+/**
+ * Try to pull an embedded conversation JSON blob out of server-rendered HTML.
+ * Covers a few known patterns; returns undefined if none match (JS-gated page).
+ */
+export declare function extractEmbeddedJson(html: string): unknown | undefined;
+/** Import from a local export file (JSON). Always reliable. */
+export declare function importFromFile(path: string, tool?: string): NsfSession;
+/** Import from raw pasted JSON text. */
+export declare function importFromText(text: string, tool?: string): NsfSession;
+/**
+ * Import from a share URL (best-effort). Throws a helpful ImportError when the
+ * page is JS-gated so the caller can steer the user to the export-file path.
+ */
+export declare function importFromUrl(url: string): Promise<NsfSession>;

package/dist/import.js

@@ -0,0 +1,129 @@
+/**
+ * `sup import` sources: a local export file, pasted text/JSON, or a share URL.
+ *
+ * Reliability ladder (honest by design):
+ *  - FILE / STDIN: fully reliable. The official export JSON is a stable contract.
+ *  - URL: best-effort. Modern share pages (ChatGPT especially) render via a JS
+ *    data loader, so a plain fetch often only sees a shell. We try to extract an
+ *    embedded conversation payload from the server HTML; if we can't, we say so
+ *    clearly and point at the reliable export-file path — we never pretend.
+ */
+import { readFileSync } from "node:fs";
+import { chatToNsf } from "./parsers/chat-export.js";
+export class ImportError extends Error {
+}
+/** Guess a provenance tool id from a URL host. */
+function toolFromUrl(url) {
+    const h = url.toLowerCase();
+    if (h.includes("chatgpt.com") || h.includes("openai.com"))
+        return "chatgpt";
+    if (h.includes("claude.ai"))
+        return "claude-web";
+    if (h.includes("gemini.google") || h.includes("g.co/gemini"))
+        return "gemini";
+    return "web-chat";
+}
+/**
+ * Try to pull an embedded conversation JSON blob out of server-rendered HTML.
+ * Covers a few known patterns; returns undefined if none match (JS-gated page).
+ */
+export function extractEmbeddedJson(html) {
+    const candidates = [];
+    // Next.js style: <script id="__NEXT_DATA__" type="application/json">{...}</script>
+    const next = /<script[^>]+id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/.exec(html);
+    if (next?.[1])
+        candidates.push(next[1]);
+    // React Router / streamed loader payloads sometimes inline JSON assignments.
+    const loader = /window\.__reactRouter[\w$]*\s*=\s*(\{[\s\S]*?\});?<\/script>/.exec(html);
+    if (loader?.[1])
+        candidates.push(loader[1]);
+    for (const raw of candidates) {
+        try {
+            const parsed = JSON.parse(raw);
+            // Walk a couple of likely nesting spots for something conversation-shaped.
+            const found = findConversation(parsed);
+            if (found)
+                return found;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return undefined;
+}
+/** Depth-limited search for an object that looks like a conversation. */
+function findConversation(node, depth = 0) {
+    if (!node || typeof node !== "object" || depth > 8)
+        return undefined;
+    const o = node;
+    if (o.mapping && typeof o.mapping === "object")
+        return o;
+    if (Array.isArray(o.messages) && o.messages.length)
+        return o;
+    for (const v of Object.values(o)) {
+        const hit = findConversation(v, depth + 1);
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+/** Import from a local export file (JSON). Always reliable. */
+export function importFromFile(path, tool = "web-chat") {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch {
+        throw new ImportError(`Could not read file: ${path}`);
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        throw new ImportError(`File is not valid JSON: ${path}`);
+    }
+    const session = chatToNsf(data, tool);
+    if (session.turns.length === 0)
+        throw new ImportError("No messages found in the export file. Is this a ChatGPT/Claude export?");
+    return session;
+}
+/** Import from raw pasted JSON text. */
+export function importFromText(text, tool = "web-chat") {
+    const data = JSON.parse(text);
+    const session = chatToNsf(data, tool);
+    if (session.turns.length === 0)
+        throw new ImportError("No messages found in the pasted content.");
+    return session;
+}
+/**
+ * Import from a share URL (best-effort). Throws a helpful ImportError when the
+ * page is JS-gated so the caller can steer the user to the export-file path.
+ */
+export async function importFromUrl(url) {
+    const tool = toolFromUrl(url);
+    let html;
+    try {
+        const res = await fetch(url, { headers: { "user-agent": "supersession-import/0.1" } });
+        if (!res.ok)
+            throw new ImportError(`Fetch failed (HTTP ${res.status}) for ${url}`);
+        html = await res.text();
+    }
+    catch (e) {
+        if (e instanceof ImportError)
+            throw e;
+        throw new ImportError(`Could not fetch ${url}: ${e instanceof Error ? e.message : e}`);
+    }
+    const data = extractEmbeddedJson(html);
+    if (!data) {
+        throw new ImportError(`Couldn't extract the conversation from the share page — it's rendered client-side.\n` +
+            `  Reliable path: export the chat (ChatGPT: Settings → Data controls → Export;\n` +
+            `  Claude: Settings → Export data), then run:\n` +
+            `    sup import <file.json> <tool>`);
+    }
+    const session = chatToNsf(data, tool);
+    if (session.turns.length === 0)
+        throw new ImportError("Extracted the page but found no messages in it.");
+    return session;
+}
+//# sourceMappingURL=import.js.map

package/dist/import.js.map

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

package/dist/llm.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Minimal, dependency-free LLM client for the smart distiller.
+ *
+ * Two paths, one interface:
+ *  - BYO key (local): reads ANTHROPIC_API_KEY or OPENAI_API_KEY from env and
+ *    calls the provider directly. Zero COGS to us; maximum trust for the user.
+ *  - Cloud (later): the hosted CLI will point SUPERSESSION_LLM_BASE at the
+ *    Cloudflare AI Gateway proxy, which meters credits. Same call shape.
+ *
+ * We deliberately don't pull in an SDK — the messages API is one fetch call and
+ * an SDK would be the only heavy dependency in the whole package.
+ */
+export type LlmComplete = (prompt: string) => Promise<string>;
+export interface LlmConfig {
+    provider: "anthropic" | "openai";
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+}
+/** Resolve config from environment. Returns undefined if no key is available. */
+export declare function resolveLlmConfig(env?: NodeJS.ProcessEnv): LlmConfig | undefined;
+/** Build a caller from config, or return undefined if no key is configured. */
+export declare function makeLlm(cfg?: LlmConfig | undefined): LlmComplete | undefined;

package/dist/llm.js

@@ -0,0 +1,90 @@
+/**
+ * Minimal, dependency-free LLM client for the smart distiller.
+ *
+ * Two paths, one interface:
+ *  - BYO key (local): reads ANTHROPIC_API_KEY or OPENAI_API_KEY from env and
+ *    calls the provider directly. Zero COGS to us; maximum trust for the user.
+ *  - Cloud (later): the hosted CLI will point SUPERSESSION_LLM_BASE at the
+ *    Cloudflare AI Gateway proxy, which meters credits. Same call shape.
+ *
+ * We deliberately don't pull in an SDK — the messages API is one fetch call and
+ * an SDK would be the only heavy dependency in the whole package.
+ */
+const DEFAULT_ANTHROPIC_MODEL = "claude-haiku-4-5";
+const DEFAULT_OPENAI_MODEL = "gpt-4.1-mini";
+/** Resolve config from environment. Returns undefined if no key is available. */
+export function resolveLlmConfig(env = process.env) {
+    const model = env.SUPERSESSION_MODEL;
+    const base = env.SUPERSESSION_LLM_BASE;
+    const anthropicKey = env.SUPERSESSION_ANTHROPIC_KEY ?? env.ANTHROPIC_API_KEY;
+    if (anthropicKey) {
+        return {
+            provider: "anthropic",
+            apiKey: anthropicKey,
+            model: model ?? DEFAULT_ANTHROPIC_MODEL,
+            baseUrl: base,
+        };
+    }
+    const openaiKey = env.SUPERSESSION_OPENAI_KEY ?? env.OPENAI_API_KEY;
+    if (openaiKey) {
+        return {
+            provider: "openai",
+            apiKey: openaiKey,
+            model: model ?? DEFAULT_OPENAI_MODEL,
+            baseUrl: base,
+        };
+    }
+    return undefined;
+}
+async function callAnthropic(cfg, prompt) {
+    const url = `${cfg.baseUrl ?? "https://api.anthropic.com"}/v1/messages`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            "x-api-key": cfg.apiKey,
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model: cfg.model,
+            max_tokens: 1500,
+            messages: [{ role: "user", content: prompt }],
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`Anthropic ${res.status}: ${await res.text()}`);
+    const data = (await res.json());
+    const text = data.content?.find((b) => b.type === "text")?.text;
+    if (!text)
+        throw new Error("Anthropic returned no text block");
+    return text;
+}
+async function callOpenai(cfg, prompt) {
+    const url = `${cfg.baseUrl ?? "https://api.openai.com"}/v1/chat/completions`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            authorization: `Bearer ${cfg.apiKey}`,
+        },
+        body: JSON.stringify({
+            model: cfg.model,
+            max_tokens: 1500,
+            messages: [{ role: "user", content: prompt }],
+        }),
+    });
+    if (!res.ok)
+        throw new Error(`OpenAI ${res.status}: ${await res.text()}`);
+    const data = (await res.json());
+    const text = data.choices?.[0]?.message?.content;
+    if (!text)
+        throw new Error("OpenAI returned no content");
+    return text;
+}
+/** Build a caller from config, or return undefined if no key is configured. */
+export function makeLlm(cfg = resolveLlmConfig()) {
+    if (!cfg)
+        return undefined;
+    return (prompt) => cfg.provider === "anthropic" ? callAnthropic(cfg, prompt) : callOpenai(cfg, prompt);
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Supersession MCP server — one door that lights up every MCP-speaking IDE
+ * (Cursor, Claude Desktop, Antigravity, VS Code). Inside any of them the user
+ * just says "hand this off to Codex" / "refresh this session" and the agent
+ * calls these tools; the engine does the same parse → distill → write it does
+ * for the CLI.
+ *
+ * CRITICAL: stdout is the JSON-RPC channel. Nothing here may write to stdout
+ * except the transport. The shared engine is stdout-silent by contract; any
+ * diagnostics go to stderr.
+ */
+export {};

package/dist/mcp.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * Supersession MCP server — one door that lights up every MCP-speaking IDE
+ * (Cursor, Claude Desktop, Antigravity, VS Code). Inside any of them the user
+ * just says "hand this off to Codex" / "refresh this session" and the agent
+ * calls these tools; the engine does the same parse → distill → write it does
+ * for the CLI.
+ *
+ * CRITICAL: stdout is the JSON-RPC channel. Nothing here may write to stdout
+ * except the transport. The shared engine is stdout-silent by contract; any
+ * diagnostics go to stderr.
+ */
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { requireSession, distillSession, NoSessionError } from "./engine.js";
+import { resolveTool, TOOLS } from "./tools.js";
+import { assessSession } from "./health.js";
+const TOOL_IDS = Object.keys(TOOLS).join(" | ");
+const server = new Server({ name: "supersession", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "handoff",
+            description: "Hand off the current coding session to another AI tool. Distills the session (goal, decisions, files, next step) and writes the target tool's kickoff file so it continues instead of restarting.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    tool: { type: "string", description: `Target tool: ${TOOL_IDS}` },
+                    cwd: { type: "string", description: "Project directory (defaults to the server's cwd)" },
+                },
+                required: ["tool"],
+            },
+        },
+        {
+            name: "refresh",
+            description: "Continue the CURRENT tool in a fresh session — beats /compact for context rot. Distills the full on-disk transcript (including turns compaction dropped) into a clean brief.",
+            inputSchema: {
+                type: "object",
+                properties: { cwd: { type: "string", description: "Project directory (defaults to server cwd)" } },
+            },
+        },
+        {
+            name: "status",
+            description: "Report session quality: size, how much is live reasoning vs tool-output noise, compaction scars, stale file references, and whether a refresh is warranted.",
+            inputSchema: {
+                type: "object",
+                properties: { cwd: { type: "string", description: "Project directory (defaults to server cwd)" } },
+            },
+        },
+    ],
+}));
+function text(s) {
+    return { content: [{ type: "text", text: s }] };
+}
+function fail(s) {
+    return { content: [{ type: "text", text: s }], isError: true };
+}
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const args = (req.params.arguments ?? {});
+    const cwd = args.cwd ?? process.cwd();
+    try {
+        if (req.params.name === "status") {
+            const h = assessSession(requireSession(cwd));
+            const lines = [
+                `Session quality (measured from the transcript):`,
+                `- ${h.turns} turns, ≈${Math.round(h.estTokens / 1000)}k tokens in window`,
+                `- ≈${Math.round(h.signalTokens / 1000)}k tokens live reasoning (${Math.round((1 - h.noiseRatio) * 100)}% signal)`,
+                h.compactions ? `- ${h.compactions} compaction scar(s)` : "",
+                h.staleRefs.length ? `- ${h.staleRefs.length} stale file reference(s)` : "",
+                ...h.signals.map((s) => `- ${s.level === "warn" ? "⚠" : "·"} ${s.detail}`),
+                h.suggestRefresh ? `→ Recommend: refresh (fresh window, full arc).` : `→ Session looks healthy.`,
+            ].filter(Boolean);
+            return text(lines.join("\n"));
+        }
+        // handoff + refresh share the distill→write path; refresh targets the source tool.
+        const nsf = requireSession(cwd);
+        const isRefresh = req.params.name === "refresh";
+        const toolId = isRefresh ? nsf.provenance.tool : args.tool;
+        if (!toolId)
+            return fail(`Missing "tool". One of: ${TOOL_IDS}`);
+        const tool = resolveTool(toolId);
+        if (!tool?.writeTarget)
+            return fail(`Unknown tool "${toolId}". One of: ${TOOL_IDS}`);
+        const { brief, note } = await distillSession(nsf, false);
+        const sourceLabel = isRefresh ? `${tool.label} (previous session)` : "Claude Code";
+        const target = tool.writeTarget(brief, sourceLabel);
+        writeFileSync(join(cwd, target.file), target.body, "utf8");
+        const summary = [
+            isRefresh ? `Refreshed into a clean ${tool.label} session.` : `Handed off to ${tool.label}.`,
+            `Wrote ${target.file} (${brief.fidelity.verbatimTurns} turns verbatim, ${brief.files.length} files).`,
+            note ? `Note: ${note}.` : "",
+            `Continue with: ${target.launchHint}`,
+        ].filter(Boolean);
+        return text(summary.join("\n"));
+    }
+    catch (e) {
+        if (e instanceof NoSessionError)
+            return fail(e.message);
+        return fail(`Supersession error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Ready. (stderr only — stdout is the protocol channel.)
+    process.stderr.write("supersession MCP server ready\n");
+}
+main().catch((e) => {
+    process.stderr.write(`fatal: ${e instanceof Error ? e.message : String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/nsf.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Neutral Session Format (NSF) — the portable, tool-agnostic representation of
+ * an AI coding session. Every parser produces NSF; every distiller and writer
+ * consumes it. This is the contract; keeping it small and honest is the whole
+ * game.
+ *
+ * Design rules:
+ * - Lossy on purpose but never *silently* lossy. If a parser can't map
+ *   something, it drops it and the distiller's fidelity report says so.
+ * - No vendor concepts leak in. "thinking", "tool_use", Codex's "AGENTS.md" —
+ *   none of those words appear here. Only turns and actions.
+ */
+export declare const NSF_VERSION: "0.1";
+/** A single tool invocation the agent made, normalized across tools. */
+export interface NsfAction {
+    /** Normalized verb: what the agent did. */
+    kind: "edit" | "write" | "read" | "run" | "search" | "other";
+    /** Tool's own name for it, kept for provenance (e.g. "Bash", "MultiEdit"). */
+    rawName: string;
+    /** File path this action touched, if any (absolute or repo-relative as recorded). */
+    path?: string;
+    /** Shell command, for `run` actions. */
+    command?: string;
+    /** Whether the tool reported this action as failed. */
+    failed?: boolean;
+}
+/** One conversational turn. Tool noise is folded into `actions`, not `text`. */
+export interface NsfTurn {
+    role: "user" | "assistant";
+    /** Human/assistant prose only. Never contains tool JSON or thinking blocks. */
+    text: string;
+    /** Actions the agent took during this turn (assistant turns only). */
+    actions: NsfAction[];
+    /** Epoch ms if the source recorded it. */
+    timestamp?: number;
+}
+/** Provenance of where this session came from. */
+export interface NsfProvenance {
+    /** Source tool id, e.g. "claude-code". */
+    tool: string;
+    /** The tool's native session id. */
+    sessionId?: string;
+    /** Absolute working directory the session ran in. */
+    cwd?: string;
+    /** Git branch recorded at capture time, if any. */
+    gitBranch?: string;
+    /**
+     * Raw size of the source transcript in bytes. NSF drops tool results and
+     * thinking, so prose alone underestimates real window pressure — health
+     * checks use this as the honest upper-bound proxy.
+     */
+    rawBytes?: number;
+    /**
+     * Number of compaction/summary events found in the source transcript. Each
+     * one is a lossy summarization the tool applied in-place — a "scar" between
+     * you and your original arc. Best-effort per tool.
+     */
+    compactions?: number;
+}
+/**
+ * What the parser had to drop or couldn't represent. Surfaced verbatim in the
+ * fidelity report — this is how we keep "lossy but not silent" honest.
+ */
+export interface NsfGap {
+    reason: string;
+    count: number;
+}
+export interface NsfSession {
+    nsfVersion: typeof NSF_VERSION;
+    provenance: NsfProvenance;
+    turns: NsfTurn[];
+    /** Distinct files touched across the whole session, in first-seen order. */
+    filesTouched: string[];
+    gaps: NsfGap[];
+}

package/dist/nsf.js

@@ -0,0 +1,14 @@
+/**
+ * Neutral Session Format (NSF) — the portable, tool-agnostic representation of
+ * an AI coding session. Every parser produces NSF; every distiller and writer
+ * consumes it. This is the contract; keeping it small and honest is the whole
+ * game.
+ *
+ * Design rules:
+ * - Lossy on purpose but never *silently* lossy. If a parser can't map
+ *   something, it drops it and the distiller's fidelity report says so.
+ * - No vendor concepts leak in. "thinking", "tool_use", Codex's "AGENTS.md" —
+ *   none of those words appear here. Only turns and actions.
+ */
+export const NSF_VERSION = "0.1";
+//# sourceMappingURL=nsf.js.map

package/dist/nsf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nsf.js","sourceRoot":"","sources":["../src/nsf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAc,CAAC"}

package/dist/parsers/chat-export.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Web-chat conversation -> NSF. Handles the two shapes real ChatGPT/Claude/
+ * Gemini data produces:
+ *
+ *  1. Official export mapping-tree (ChatGPT `conversations.json`):
+ *     { title, mapping: { <id>: { message: { author:{role}, content:{parts|text}, create_time }, parent, children } } }
+ *
+ *  2. Simple linear form (many exporters, share-page loader payloads):
+ *     { messages: [ { role, content }, ... ] }  OR  a bare [ {role,content}, ... ]
+ *
+ * Web chats have no local tool actions or file edits, so NSF turns carry prose
+ * only. That's honest: an imported chat is a plan/discussion, and the receiving
+ * coding tool is what will actually touch files.
+ */
+import type { NsfSession } from "../nsf.js";
+/**
+ * Convert parsed web-chat JSON into an NSF session.
+ * @param data parsed conversation JSON (export or linear form)
+ * @param tool provenance id, e.g. "chatgpt" | "claude-web" | "gemini"
+ */
+export declare function chatToNsf(data: unknown, tool: string): NsfSession;

package/dist/parsers/chat-export.js

@@ -0,0 +1,107 @@
+/**
+ * Web-chat conversation -> NSF. Handles the two shapes real ChatGPT/Claude/
+ * Gemini data produces:
+ *
+ *  1. Official export mapping-tree (ChatGPT `conversations.json`):
+ *     { title, mapping: { <id>: { message: { author:{role}, content:{parts|text}, create_time }, parent, children } } }
+ *
+ *  2. Simple linear form (many exporters, share-page loader payloads):
+ *     { messages: [ { role, content }, ... ] }  OR  a bare [ {role,content}, ... ]
+ *
+ * Web chats have no local tool actions or file edits, so NSF turns carry prose
+ * only. That's honest: an imported chat is a plan/discussion, and the receiving
+ * coding tool is what will actually touch files.
+ */
+import { NSF_VERSION } from "../nsf.js";
+/** Pull plain text out of the many content shapes a chat message can have. */
+function contentToText(content) {
+    if (typeof content === "string")
+        return content.trim();
+    if (Array.isArray(content))
+        return content.map(contentToText).filter(Boolean).join("\n").trim();
+    if (content && typeof content === "object") {
+        const o = content;
+        if (Array.isArray(o.parts))
+            return o.parts
+                .map((p) => (typeof p === "string" ? p : typeof p === "object" && p ? contentToText(p) : ""))
+                .filter(Boolean)
+                .join("\n")
+                .trim();
+        if (typeof o.text === "string")
+            return o.text.trim();
+        if (typeof o.content === "string")
+            return o.content.trim();
+    }
+    return "";
+}
+/** Extract an ordered list of {role,text} from either supported shape. */
+function extractMessages(data) {
+    if (!data || typeof data !== "object")
+        return { msgs: [] };
+    const obj = data;
+    // Shape 1: mapping tree. Linearize by create_time (robust vs. tree-walking).
+    if (obj.mapping && typeof obj.mapping === "object") {
+        const nodes = Object.values(obj.mapping);
+        const msgs = [];
+        for (const node of nodes) {
+            const m = node.message;
+            if (!m)
+                continue;
+            const role = m.author?.role ?? "unknown";
+            const text = contentToText(m.content);
+            if (!text)
+                continue;
+            const ts = typeof m.create_time === "number" ? m.create_time * 1000 : undefined;
+            msgs.push({ role, text, ts });
+        }
+        msgs.sort((a, b) => (a.ts ?? 0) - (b.ts ?? 0));
+        return { msgs, title: typeof obj.title === "string" ? obj.title : undefined };
+    }
+    // Shape 2: linear messages array (nested or bare).
+    const arr = Array.isArray(data) ? data : Array.isArray(obj.messages) ? obj.messages : undefined;
+    if (arr) {
+        const msgs = [];
+        for (const m of arr) {
+            if (!m || typeof m !== "object")
+                continue;
+            const mo = m;
+            const role = mo.role ?? mo.author ?? "unknown";
+            const text = contentToText(mo.content ?? mo.text ?? mo.message);
+            if (text)
+                msgs.push({ role, text });
+        }
+        return { msgs, title: typeof obj.title === "string" ? obj.title : undefined };
+    }
+    return { msgs: [] };
+}
+/**
+ * Convert parsed web-chat JSON into an NSF session.
+ * @param data parsed conversation JSON (export or linear form)
+ * @param tool provenance id, e.g. "chatgpt" | "claude-web" | "gemini"
+ */
+export function chatToNsf(data, tool) {
+    const { msgs } = extractMessages(data);
+    const turns = [];
+    let systemDropped = 0;
+    for (const m of msgs) {
+        const role = m.role === "user" ? "user" : m.role === "assistant" ? "assistant" : null;
+        if (!role) {
+            systemDropped++;
+            continue;
+        }
+        turns.push({ role, text: m.text, actions: [], timestamp: m.ts });
+    }
+    const gaps = [];
+    if (systemDropped)
+        gaps.push({ reason: "non-user/assistant message", count: systemDropped });
+    if (turns.length === 0)
+        gaps.push({ reason: "no recognizable messages in source", count: 1 });
+    return {
+        nsfVersion: NSF_VERSION,
+        provenance: { tool },
+        turns,
+        filesTouched: [],
+        gaps,
+    };
+}
+//# sourceMappingURL=chat-export.js.map