@alsdd/t3-import 0.0.0-stage → 0.1.1-alsd.1

package/dist/core/checkpoint.d.ts

@@ -0,0 +1,25 @@
+import type { CanonicalTerminalTurnStatus, CanonicalThread, CanonicalTurn } from "./types.js";
+export interface TurnCheckpointV1 {
+    id: string;
+    hash: string;
+}
+export interface ImportCheckpointV1 {
+    version: 1;
+    turns: TurnCheckpointV1[];
+}
+export interface TurnCheckpointV2 {
+    id: string;
+    status: CanonicalTerminalTurnStatus;
+    terminalReason?: string;
+    terminalError?: string;
+    hash: string;
+}
+export interface ImportCheckpointV2 {
+    version: 2;
+    turns: TurnCheckpointV2[];
+}
+export type ImportCheckpoint = ImportCheckpointV1 | ImportCheckpointV2;
+export declare function legacyTurnSemanticHash(turn: CanonicalTurn): string;
+export declare function turnSemanticHash(turn: CanonicalTurn): string;
+export declare function checkpointForThread(thread: CanonicalThread): ImportCheckpointV2;
+export declare function parseCheckpoint(value: string | null | undefined): ImportCheckpoint | undefined;

package/dist/core/checkpoint.js

@@ -0,0 +1,82 @@
+import { isTerminalTurn } from "./types.js";
+import { sha256 } from "./util.js";
+function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    if (value && typeof value === "object") {
+        const record = value;
+        return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(record[key])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+function turnHashPayload(turn) {
+    return {
+        id: turn.id,
+        startedAt: turn.startedAt,
+        completedAt: turn.completedAt ?? null,
+        user: {
+            sourceId: turn.user.sourceId,
+            text: turn.user.text,
+            timestamp: turn.user.timestamp,
+            attachments: turn.user.attachments.map((attachment) => ({
+                sourceId: attachment.sourceId,
+                name: attachment.name,
+                mimeType: attachment.mimeType,
+                sizeBytes: attachment.sizeBytes,
+                remoteUrl: attachment.remoteUrl ?? null,
+                contentHash: attachment.data ? sha256(attachment.data) : null,
+            })),
+        },
+        assistant: turn.assistant.map((message) => ({ sourceId: message.sourceId, text: message.text, timestamp: message.timestamp })),
+        activities: turn.activities.map((activity) => ({ sourceId: activity.sourceId, kind: activity.kind, tone: activity.tone, summary: activity.summary, timestamp: activity.timestamp, payload: activity.payload })),
+        plans: turn.plans.map((plan) => ({ sourceId: plan.sourceId, markdown: plan.markdown, timestamp: plan.timestamp })),
+    };
+}
+export function legacyTurnSemanticHash(turn) {
+    return sha256(canonicalJson({
+        ...turnHashPayload(turn),
+        complete: true,
+    }));
+}
+export function turnSemanticHash(turn) {
+    return sha256(canonicalJson({
+        ...turnHashPayload(turn),
+        status: turn.status,
+        terminalReason: turn.terminalReason ?? null,
+        terminalError: turn.terminalError ?? null,
+    }));
+}
+export function checkpointForThread(thread) {
+    return {
+        version: 2,
+        turns: thread.turns.filter(isTerminalTurn).map((turn) => ({
+            id: turn.id,
+            status: turn.status,
+            ...(turn.terminalReason ? { terminalReason: turn.terminalReason } : {}),
+            ...(turn.terminalError ? { terminalError: turn.terminalError } : {}),
+            hash: turnSemanticHash(turn),
+        })),
+    };
+}
+export function parseCheckpoint(value) {
+    if (!value)
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed.turns))
+            return undefined;
+        if (!parsed.turns.every((turn) => typeof turn.id === "string" && typeof turn.hash === "string"))
+            return undefined;
+        if (parsed.version === 1)
+            return parsed;
+        if (parsed.version !== 2)
+            return undefined;
+        if (!parsed.turns.every((turn) => ["completed", "interrupted", "failed"].includes(turn.status)))
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/core/checkpoint.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,12 @@
+export type ExitCode = 2 | 3 | 4 | 5 | 6 | 7;
+export declare class ImporterError extends Error {
+    readonly exitCode: ExitCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, exitCode: ExitCode, details?: unknown | undefined);
+}
+export declare const usageError: (message: string) => ImporterError;
+export declare const compatibilityError: (message: string) => ImporterError;
+export declare const safetyError: (message: string) => ImporterError;
+export declare const sourceError: (message: string, details?: unknown) => ImporterError;
+export declare const writeError: (message: string, details?: unknown) => ImporterError;
+export declare const syncConflictError: (message: string, details?: unknown) => ImporterError;

package/dist/core/errors.js

@@ -0,0 +1,17 @@
+export class ImporterError extends Error {
+    exitCode;
+    details;
+    constructor(message, exitCode, details) {
+        super(message);
+        this.exitCode = exitCode;
+        this.details = details;
+        this.name = "ImporterError";
+    }
+}
+export const usageError = (message) => new ImporterError(message, 2);
+export const compatibilityError = (message) => new ImporterError(message, 3);
+export const safetyError = (message) => new ImporterError(message, 4);
+export const sourceError = (message, details) => new ImporterError(message, 5, details);
+export const writeError = (message, details) => new ImporterError(message, 6, details);
+export const syncConflictError = (message, details) => new ImporterError(message, 7, details);
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAG3B;IACA;IAHX,YACE,OAAe,EACN,QAAkB,EAClB,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,aAAQ,GAAR,QAAQ,CAAU;QAClB,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,OAAiB,EAAE,EAAE,CAChE,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,OAAiB,EAAE,EAAE,CAC/D,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,OAAiB,EAAE,EAAE,CACtE,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC"}

package/dist/core/jsonl.d.ts

@@ -0,0 +1,7 @@
+export interface JsonlSnapshot {
+    rows: unknown[];
+    fingerprint: string;
+    mtimeMs: number;
+    size: number;
+}
+export declare function readStableJsonl(path: string): Promise<JsonlSnapshot>;

package/dist/core/jsonl.js

@@ -0,0 +1,37 @@
+import { createReadStream, statSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { sha256 } from "./util.js";
+async function readOnce(path) {
+    const before = statSync(path);
+    const rows = [];
+    const hashParts = [];
+    const lines = createInterface({ input: createReadStream(path, { encoding: "utf8" }), crlfDelay: Infinity });
+    for await (const line of lines) {
+        if (!line.trim())
+            continue;
+        hashParts.push(line, "\n");
+        try {
+            rows.push(JSON.parse(line));
+        }
+        catch (error) {
+            throw new Error(`Invalid JSONL in ${path}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    const after = statSync(path);
+    if (before.size !== after.size || before.mtimeMs !== after.mtimeMs) {
+        throw new Error("SOURCE_CHANGED_DURING_READ");
+    }
+    return { rows, fingerprint: sha256(hashParts.join("")), mtimeMs: after.mtimeMs, size: after.size };
+}
+export async function readStableJsonl(path) {
+    try {
+        return await readOnce(path);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === "SOURCE_CHANGED_DURING_READ") {
+            return readOnce(path);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/core/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../src/core/jsonl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASnC,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5G,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACrG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,4BAA4B,EAAE,CAAC;YAC7E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/providers.d.ts

@@ -0,0 +1,6 @@
+import type { CanonicalThread } from "./types.js";
+export declare const sourceNames: readonly ["codex", "claude", "opencode"];
+export type ProviderDriver = "codex" | "claudeAgent" | "opencode";
+export declare function sourceDriver(source: string): ProviderDriver;
+export declare function sourceFromDriver(driver: string): typeof sourceNames[number] | undefined;
+export declare function nativeSessionId(thread: CanonicalThread): string | undefined;

package/dist/core/providers.js

@@ -0,0 +1,17 @@
+import { stringValue } from "./util.js";
+import { usageError } from "./errors.js";
+export const sourceNames = ["codex", "claude", "opencode"];
+const drivers = { codex: "codex", claude: "claudeAgent", opencode: "opencode" };
+export function sourceDriver(source) {
+    if (!Object.hasOwn(drivers, source))
+        throw usageError(`Unsupported source: ${source}`);
+    return drivers[source];
+}
+export function sourceFromDriver(driver) {
+    return sourceNames.find((source) => sourceDriver(source) === driver);
+}
+export function nativeSessionId(thread) {
+    const key = thread.source === "codex" ? "threadId" : thread.source === "claude" ? "resume" : "sessionId";
+    return stringValue(thread.resumeCursor?.[key]);
+}
+//# sourceMappingURL=providers.js.map

package/dist/core/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/core/providers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAEpE,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAW,CAAC;AACzF,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,MAAM,UAAU,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;IACvF,OAAO,OAAO,CAAC,MAAoC,CAAC,CAAC;AACvD,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;AACvE,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IACzG,OAAO,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,247 @@
+import type { sourceNames } from "./providers.js";
+export type SourceName = typeof sourceNames[number];
+export type ActivityTone = "info" | "tool" | "approval" | "error";
+export type CanonicalTurnStatus = "completed" | "interrupted" | "failed" | "inProgress";
+export type CanonicalTerminalTurnStatus = Exclude<CanonicalTurnStatus, "inProgress">;
+export interface SourceSummary {
+    source: SourceName;
+    id: string;
+    title: string;
+    workspace: string;
+    path: string;
+    createdAt: string;
+    updatedAt: string;
+    status: "complete" | "incomplete";
+    branches: number;
+    parentId?: string;
+}
+export interface SourceAttachment {
+    sourceId: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    path?: string;
+    data?: Buffer;
+    remoteUrl?: string;
+}
+export interface CanonicalMessage {
+    sourceId: string;
+    role: "user" | "assistant";
+    text: string;
+    timestamp: string;
+    attachments: SourceAttachment[];
+}
+export interface CanonicalActivity {
+    sourceId: string;
+    tone: ActivityTone;
+    kind: string;
+    summary: string;
+    payload: Record<string, unknown>;
+    timestamp: string;
+}
+export interface CanonicalPlan {
+    sourceId: string;
+    markdown: string;
+    timestamp: string;
+}
+export interface CanonicalTurn {
+    id: string;
+    startedAt: string;
+    completedAt?: string;
+    status: CanonicalTurnStatus;
+    terminalReason?: string;
+    terminalError?: string;
+    user: CanonicalMessage;
+    assistant: CanonicalMessage[];
+    activities: CanonicalActivity[];
+    plans: CanonicalPlan[];
+}
+export interface CanonicalThread {
+    source: SourceName;
+    sourceSessionId: string;
+    sourceKey: string;
+    leafId?: string;
+    currentBranch: boolean;
+    title: string;
+    workspace: string;
+    gitBranch?: string;
+    model: string;
+    modelOptions?: Array<{
+        id: string;
+        value: string | boolean;
+    }>;
+    effort?: string;
+    createdAt: string;
+    updatedAt: string;
+    turns: CanonicalTurn[];
+    ignoredInProgressTurns?: number;
+    resumeCursor?: Record<string, unknown>;
+    warnings: string[];
+}
+export interface CanonicalConversation {
+    summary: SourceSummary;
+    threads: CanonicalThread[];
+    fingerprint: string;
+}
+export interface DiscoveryOptions {
+    workspace?: string;
+    since?: Date;
+    includeIncomplete?: boolean;
+}
+export interface SourceAdapter {
+    readonly name: SourceName;
+    discover(options: DiscoveryOptions): Promise<SourceSummary[]>;
+    load(summary: SourceSummary, options: DiscoveryOptions): Promise<CanonicalConversation>;
+    dispose?(): Promise<void>;
+}
+export interface TargetPaths {
+    t3Home: string;
+    stateDir: string;
+    dbPath: string;
+    attachmentsDir: string;
+    runtimeStatePath: string;
+    settingsPath: string;
+}
+export interface ImportSelection {
+    conversation: CanonicalConversation;
+    resume: boolean;
+}
+export interface ImportItemResult {
+    source: SourceName;
+    sourceId: string;
+    sourceKey: string;
+    status: "imported" | "already-imported" | "dry-run";
+    threadId: string;
+    projectId: string;
+    sourceWorkspace?: string;
+    workingDirectory?: string;
+    title: string;
+    turns: number;
+    messages: number;
+    activities: number;
+    events: number;
+    attachments: number;
+    resumable: boolean;
+    warnings: string[];
+    sequence?: {
+        first: number;
+        last: number;
+    };
+}
+export interface ImportRunResult {
+    schemaVersion: 1;
+    status: "imported" | "dry-run" | "already-imported" | "mixed";
+    target: string;
+    migration: number;
+    backup: string | null;
+    cache?: CacheResetResult;
+    results: ImportItemResult[];
+    warnings: string[];
+}
+export type SyncItemStatus = "synced" | "up-to-date" | "history-diverged" | "branch-sync-unsupported" | "target-missing" | "not-imported" | "dry-run";
+export type SyncTitleAction = "updated" | "unchanged" | "preserved-local";
+export interface SyncItemResult {
+    source: SourceName;
+    sourceId: string;
+    sourceKey: string;
+    status: SyncItemStatus;
+    threadId?: string;
+    projectId?: string;
+    title: string;
+    turnsAdded: number;
+    turnsAdopted: number;
+    events: number;
+    attachments: number;
+    titleAction: SyncTitleAction;
+    resumable: boolean;
+    warnings: string[];
+    sequence?: {
+        first: number;
+        last: number;
+    };
+}
+export interface SyncRunResult {
+    schemaVersion: 1;
+    status: "synced" | "up-to-date" | "dry-run" | "mixed" | "conflict";
+    target: string;
+    migration: number;
+    backup: string | null;
+    cache?: CacheResetResult;
+    results: SyncItemResult[];
+    warnings: string[];
+    hasConflicts: boolean;
+}
+export interface CacheResetResult {
+    status: "reset" | "not-found";
+    backup: string | null;
+    profile: string | null;
+    entries: string[];
+    warnings: string[];
+}
+export interface ReplaceSelection {
+    conversation: CanonicalConversation;
+}
+export type ReplaceItemStatus = "replaced" | "already-current" | "not-imported" | "active-source" | "branch-replace-unsupported" | "target-missing" | "dry-run";
+export interface ReplaceItemResult {
+    source: SourceName;
+    sourceId: string;
+    sourceKey: string;
+    status: ReplaceItemStatus;
+    oldThreadId?: string;
+    newThreadId?: string;
+    projectId?: string;
+    title: string;
+    turns: number;
+    events: number;
+    attachments: number;
+    resumeTransferred: boolean;
+    oldThreadIds?: string[];
+    warnings: string[];
+    sequence?: {
+        first: number;
+        last: number;
+    };
+}
+export interface ReplaceRunResult {
+    schemaVersion: 1;
+    status: "replaced" | "already-current" | "dry-run" | "mixed" | "conflict";
+    target: string;
+    migration: number;
+    backup: string | null;
+    cache?: CacheResetResult;
+    results: ReplaceItemResult[];
+    warnings: string[];
+    hasConflicts: boolean;
+}
+export interface ConversationReplacePreview {
+    sourceId: string;
+    status: Exclude<ReplaceItemStatus, "replaced" | "dry-run"> | "replaceable";
+    selectable: boolean;
+    previouslyImported: boolean;
+    turns: number;
+    events: number;
+    attachments: number;
+    oldThreadId?: string;
+    oldThreadIds?: string[];
+    newThreadId?: string;
+    warnings: string[];
+}
+export interface SyncSelection {
+    conversation: CanonicalConversation;
+}
+export interface ConversationSyncPreview {
+    sourceId: string;
+    status: "new" | "active-only" | "syncable" | "up-to-date" | "history-diverged" | "branch-sync-unsupported" | "target-missing";
+    newTurns: number;
+    newCompletedTurns: number;
+    newInterruptedTurns: number;
+    newFailedTurns: number;
+    ignoredActiveTurns: number;
+    adoptedTurns: number;
+    titleChanged: boolean;
+    selectable: boolean;
+    previouslyImported: boolean;
+    threadId?: string;
+    warnings: string[];
+}
+export declare function isTerminalTurn(turn: CanonicalTurn): boolean;

package/dist/core/types.js

@@ -0,0 +1,4 @@
+export function isTerminalTurn(turn) {
+    return turn.status !== "inProgress";
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAmRA,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC;AACtC,CAAC"}

package/dist/core/util.d.ts

@@ -0,0 +1,14 @@
+export type JsonObject = Record<string, unknown>;
+export declare function isObject(value: unknown): value is JsonObject;
+export declare function stringValue(value: unknown): string | undefined;
+export declare function isoTimestamp(value: unknown, fallback: string): string;
+export declare function sha256(value: string | Buffer): string;
+export declare function deterministicUuid(value: string): string;
+export declare function canonicalPath(input: string): string;
+export declare function pathContains(parent: string, child: string): boolean;
+export declare function truncate(value: string, limit?: number): string;
+export declare function deriveTitle(text: string, fallback?: string): string;
+export declare function sortStable<T extends {
+    timestamp: string;
+    sourceId: string;
+}>(items: T[]): T[];

package/dist/core/util.js

@@ -0,0 +1,61 @@
+import { createHash } from "node:crypto";
+import { realpathSync } from "node:fs";
+import { isAbsolute, normalize, resolve } from "node:path";
+export function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function stringValue(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+export function isoTimestamp(value, fallback) {
+    if (typeof value !== "string" && typeof value !== "number")
+        return fallback;
+    const parsed = typeof value === "number" && value < 10_000_000_000
+        ? new Date(value * 1_000)
+        : new Date(value);
+    return Number.isNaN(parsed.valueOf()) ? fallback : parsed.toISOString();
+}
+export function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function deterministicUuid(value) {
+    const bytes = createHash("sha256").update(value).digest().subarray(0, 16);
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString("hex");
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+export function canonicalPath(input) {
+    const absolute = isAbsolute(input) ? normalize(input) : resolve(input);
+    let result = absolute;
+    try {
+        result = realpathSync.native(absolute);
+    }
+    catch {
+        // Historical source workspaces can be missing; keep the normalized path.
+    }
+    result = result.replace(/[\\/]+$/u, "");
+    return process.platform === "win32" || process.platform === "darwin"
+        ? result.toLowerCase()
+        : result;
+}
+export function pathContains(parent, child) {
+    const normalizedParent = canonicalPath(parent);
+    const normalizedChild = canonicalPath(child);
+    if (normalizedParent === normalizedChild)
+        return true;
+    const separator = process.platform === "win32" ? "\\" : "/";
+    return normalizedChild.startsWith(`${normalizedParent}${separator}`);
+}
+export function truncate(value, limit = 180) {
+    const normalized = value.trim();
+    return normalized.length <= limit ? normalized : `${normalized.slice(0, limit - 1)}…`;
+}
+export function deriveTitle(text, fallback = "Imported conversation") {
+    const line = text.split(/\r?\n/u).find((entry) => entry.trim().length > 0)?.trim() ?? fallback;
+    return truncate(line, 72);
+}
+export function sortStable(items) {
+    return items.sort((left, right) => left.timestamp.localeCompare(right.timestamp) || left.sourceId.localeCompare(right.sourceId));
+}
+//# sourceMappingURL=util.js.map

package/dist/core/util.js.map

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

package/dist/sources/claude.d.ts

@@ -0,0 +1,6 @@
+import type { CanonicalConversation, DiscoveryOptions, SourceAdapter, SourceSummary } from "../core/types.js";
+export declare class ClaudeSource implements SourceAdapter {
+    readonly name: "claude";
+    discover(options: DiscoveryOptions): Promise<SourceSummary[]>;
+    load(summary: SourceSummary, options: DiscoveryOptions): Promise<CanonicalConversation>;
+}