conversationalist 0.0.6 → 0.0.8

package/dist/schemas.d.ts

@@ -1,6 +1,14 @@
+import type { MultiModalContent } from '@lasercat/homogenaize';
 import { z } from 'zod';
-import type { ConversationJSON, ConversationStatus, MessageInput, MessageJSON, MessageRole, TokenUsage, ToolCall, ToolResult } from './types';
-export declare const multiModalContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+import type { JSONValue } from './types';
+/**
+ * Zod schema for JSON-serializable values.
+ */
+export declare const jsonValueSchema: z.ZodType<JSONValue>;
+/**
+ * Zod schema for multi-modal content parts (text or image).
+ */
+export declare const multiModalContentSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;
     text: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -8,23 +16,325 @@ export declare const multiModalContentSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     url: z.ZodString;
     mimeType: z.ZodOptional<z.ZodString>;
     text: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>], "type">;
-export declare const messageRoleSchema: z.ZodType<MessageRole>;
-export declare const toolCallSchema: z.ZodType<ToolCall>;
-export declare const toolResultSchema: z.ZodType<ToolResult>;
-export declare const tokenUsageSchema: z.ZodType<TokenUsage>;
-export declare const messageInputSchema: z.ZodType<MessageInput>;
-export declare const messageJSONSchema: z.ZodType<MessageJSON>;
-export declare const conversationStatusSchema: z.ZodType<ConversationStatus>;
+}, z.core.$strip>], "type">, z.ZodTransform<MultiModalContent, {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    url: string;
+    mimeType?: string | undefined;
+    text?: string | undefined;
+}>>;
+/**
+ * Zod schema for valid message roles.
+ */
+export declare const messageRoleSchema: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    system: "system";
+    developer: "developer";
+    "tool-use": "tool-use";
+    "tool-result": "tool-result";
+    snapshot: "snapshot";
+}>;
+/**
+ * Zod schema for tool call metadata.
+ */
+export declare const toolCallSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for tool result metadata.
+ */
+export declare const toolResultSchema: z.ZodObject<{
+    callId: z.ZodString;
+    outcome: z.ZodEnum<{
+        success: "success";
+        error: "error";
+    }>;
+    content: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for token usage accounting.
+ */
+export declare const tokenUsageSchema: z.ZodObject<{
+    prompt: z.ZodNumber;
+    completion: z.ZodNumber;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Zod schema for message input payloads.
+ */
+export declare const messageInputSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        system: "system";
+        developer: "developer";
+        "tool-use": "tool-use";
+        "tool-result": "tool-result";
+        snapshot: "snapshot";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">, z.ZodTransform<MultiModalContent, {
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        url: string;
+        mimeType?: string | undefined;
+        text?: string | undefined;
+    }>>>]>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    toolCall: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+    }, z.core.$strip>>;
+    toolResult: z.ZodOptional<z.ZodObject<{
+        callId: z.ZodString;
+        outcome: z.ZodEnum<{
+            success: "success";
+            error: "error";
+        }>;
+        content: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        toolName: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    tokenUsage: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodNumber;
+        completion: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    goalCompleted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Zod schema for serialized messages.
+ */
+export declare const messageJSONSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        system: "system";
+        developer: "developer";
+        "tool-use": "tool-use";
+        "tool-result": "tool-result";
+        snapshot: "snapshot";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        url: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">, z.ZodTransform<MultiModalContent, {
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        url: string;
+        mimeType?: string | undefined;
+        text?: string | undefined;
+    }>>>]>;
+    position: z.ZodNumber;
+    createdAt: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+    hidden: z.ZodBoolean;
+    toolCall: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+    }, z.core.$strip>>;
+    toolResult: z.ZodOptional<z.ZodObject<{
+        callId: z.ZodString;
+        outcome: z.ZodEnum<{
+            success: "success";
+            error: "error";
+        }>;
+        content: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        toolName: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    tokenUsage: z.ZodOptional<z.ZodObject<{
+        prompt: z.ZodNumber;
+        completion: z.ZodNumber;
+        total: z.ZodNumber;
+    }, z.core.$strip>>;
+    goalCompleted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>;
+/**
+ * Zod schema for conversation status values.
+ */
+export declare const conversationStatusSchema: z.ZodEnum<{
+    active: "active";
+    archived: "archived";
+    deleted: "deleted";
+}>;
+/**
+ * Raw conversation shape for storage systems that need direct access to fields.
+ */
 export declare const conversationShape: {
+    readonly schemaVersion: z.ZodNumber;
     readonly id: z.ZodString;
     readonly title: z.ZodOptional<z.ZodString>;
-    readonly status: z.ZodType<ConversationStatus, unknown, z.core.$ZodTypeInternals<ConversationStatus, unknown>>;
-    readonly metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    readonly tags: z.ZodArray<z.ZodString>;
-    readonly messages: z.ZodArray<z.ZodType<MessageJSON, unknown, z.core.$ZodTypeInternals<MessageJSON, unknown>>>;
+    readonly status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+        deleted: "deleted";
+    }>;
+    readonly metadata: z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+    readonly ids: z.ZodArray<z.ZodString>;
+    readonly messages: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            system: "system";
+            developer: "developer";
+            "tool-use": "tool-use";
+            "tool-result": "tool-result";
+            snapshot: "snapshot";
+        }>;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">, z.ZodTransform<MultiModalContent, {
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            url: string;
+            mimeType?: string | undefined;
+            text?: string | undefined;
+        }>>>]>;
+        position: z.ZodNumber;
+        createdAt: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+        hidden: z.ZodBoolean;
+        toolCall: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+        }, z.core.$strip>>;
+        toolResult: z.ZodOptional<z.ZodObject<{
+            callId: z.ZodString;
+            outcome: z.ZodEnum<{
+                success: "success";
+                error: "error";
+            }>;
+            content: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            toolName: z.ZodOptional<z.ZodString>;
+            result: z.ZodOptional<z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        tokenUsage: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodNumber;
+            completion: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>>;
+        goalCompleted: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
     readonly createdAt: z.ZodString;
     readonly updatedAt: z.ZodString;
 };
-export declare const conversationSchema: z.ZodType<ConversationJSON>;
+/**
+ * Zod schema for serialized conversations.
+ */
+export declare const conversationSchema: z.ZodObject<{
+    schemaVersion: z.ZodNumber;
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+        deleted: "deleted";
+    }>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+    ids: z.ZodArray<z.ZodString>;
+    messages: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+            system: "system";
+            developer: "developer";
+            "tool-use": "tool-use";
+            "tool-result": "tool-result";
+            snapshot: "snapshot";
+        }>;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            url: z.ZodString;
+            mimeType: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">, z.ZodTransform<MultiModalContent, {
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            url: string;
+            mimeType?: string | undefined;
+            text?: string | undefined;
+        }>>>]>;
+        position: z.ZodNumber;
+        createdAt: z.ZodString;
+        metadata: z.ZodRecord<z.ZodString, z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+        hidden: z.ZodBoolean;
+        toolCall: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+        }, z.core.$strip>>;
+        toolResult: z.ZodOptional<z.ZodObject<{
+            callId: z.ZodString;
+            outcome: z.ZodEnum<{
+                success: "success";
+                error: "error";
+            }>;
+            content: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            toolName: z.ZodOptional<z.ZodString>;
+            result: z.ZodOptional<z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        tokenUsage: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodNumber;
+            completion: z.ZodNumber;
+            total: z.ZodNumber;
+        }, z.core.$strip>>;
+        goalCompleted: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,uBAAuB;;;;;;;;2BAQlC,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAQb,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAExC,eAAO,MAAM,cAAc,EAIV,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErC,eAAO,MAAM,gBAAgB,EAIZ,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvC,eAAO,MAAM,gBAAgB,EAIZ,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvC,eAAO,MAAM,kBAAkB,EASd,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAEzC,eAAO,MAAM,iBAAiB,EAcC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,wBAAwB,EAIpB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAG/C,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX,eAAO,MAAM,kBAAkB,EAEf,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAGV,SAAS,EAOV,MAAM,SAAS,CAAC;AAiBjB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CASjB,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;GAaoC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;EAQK,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,cAAc;;;;iBAIK,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAQK,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAIK,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASK,CAAC;AAErC;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcS,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;EAIK,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAUpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAEI,CAAC"}

package/dist/sort/index.d.ts

@@ -0,0 +1,2 @@
+export { sortMessagesByPosition, sortObjectKeys } from '../utilities/deterministic';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sort/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/sort/index.js

@@ -0,0 +1,32 @@
+// src/utilities/deterministic.ts
+function sortObjectKeys(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
+  }
+  if (Array.isArray(obj)) {
+    return obj.map(sortObjectKeys);
+  }
+  const sorted = {};
+  const keys = Object.keys(obj).sort();
+  for (const key of keys) {
+    sorted[key] = sortObjectKeys(obj[key]);
+  }
+  return sorted;
+}
+function sortMessagesByPosition(messages) {
+  return [...messages].sort((a, b) => {
+    if (a.position !== b.position) {
+      return a.position - b.position;
+    }
+    if (a.createdAt !== b.createdAt) {
+      return a.createdAt.localeCompare(b.createdAt);
+    }
+    return a.id.localeCompare(b.id);
+  });
+}
+export {
+  sortObjectKeys,
+  sortMessagesByPosition
+};
+
+//# debugId=9E6B840DBB18422664756E2164756E21

package/dist/sort/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../src/utilities/deterministic.ts"],
+  "sourcesContent": [
+    "/**\n * Recursively sorts object keys alphabetically for deterministic JSON output.\n * Arrays are processed recursively but maintain their element order.\n * Primitives and null are returned as-is.\n *\n * @param obj - The value to process\n * @returns A new object with sorted keys (or the original value for non-objects)\n *\n * @example\n * ```ts\n * sortObjectKeys({ z: 1, a: 2 });\n * // Returns: { a: 2, z: 1 }\n *\n * sortObjectKeys({ b: { y: 1, x: 2 }, a: 1 });\n * // Returns: { a: 1, b: { x: 2, y: 1 } }\n * ```\n */\nexport function sortObjectKeys<T>(obj: T): T {\n  if (obj === null || typeof obj !== 'object') {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(sortObjectKeys) as T;\n  }\n\n  const sorted: Record<string, unknown> = {};\n  const keys = Object.keys(obj as object).sort();\n\n  for (const key of keys) {\n    sorted[key] = sortObjectKeys((obj as Record<string, unknown>)[key]);\n  }\n\n  return sorted as T;\n}\n\n/**\n * Sorts messages by position for deterministic output.\n * When positions are equal, falls back to createdAt, then id.\n *\n * @param messages - Array of messages to sort\n * @returns A new sorted array (does not mutate the original)\n *\n * @example\n * ```ts\n * const sorted = sortMessagesByPosition(messages);\n * // Messages are ordered by position (ascending)\n * ```\n */\nexport function sortMessagesByPosition<\n  T extends { position: number; createdAt: string; id: string },\n>(messages: readonly T[]): T[] {\n  return [...messages].sort((a, b) => {\n    if (a.position !== b.position) {\n      return a.position - b.position;\n    }\n    if (a.createdAt !== b.createdAt) {\n      return a.createdAt.localeCompare(b.createdAt);\n    }\n    return a.id.localeCompare(b.id);\n  });\n}\n"
+  ],
+  "mappings": ";AAiBO,SAAS,cAAiB,CAAC,KAAW;AAAA,EAC3C,IAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAAA,IAC3C,OAAO;AAAA,EACT;AAAA,EAEA,IAAI,MAAM,QAAQ,GAAG,GAAG;AAAA,IACtB,OAAO,IAAI,IAAI,cAAc;AAAA,EAC/B;AAAA,EAEA,MAAM,SAAkC,CAAC;AAAA,EACzC,MAAM,OAAO,OAAO,KAAK,GAAa,EAAE,KAAK;AAAA,EAE7C,WAAW,OAAO,MAAM;AAAA,IACtB,OAAO,OAAO,eAAgB,IAAgC,IAAI;AAAA,EACpE;AAAA,EAEA,OAAO;AAAA;AAgBF,SAAS,sBAEf,CAAC,UAA6B;AAAA,EAC7B,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM;AAAA,IAClC,IAAI,EAAE,aAAa,EAAE,UAAU;AAAA,MAC7B,OAAO,EAAE,WAAW,EAAE;AAAA,IACxB;AAAA,IACA,IAAI,EAAE,cAAc,EAAE,WAAW;AAAA,MAC/B,OAAO,EAAE,UAAU,cAAc,EAAE,SAAS;AAAA,IAC9C;AAAA,IACA,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,GAC/B;AAAA;",
+  "debugId": "9E6B840DBB18422664756E2164756E21",
+  "names": []
+}

package/dist/streaming.d.ts

@@ -1,6 +1,6 @@
 import type { MultiModalContent } from '@lasercat/homogenaize';
 import { type ConversationEnvironment } from './environment';
-import type { Conversation, Message, TokenUsage } from './types';
+import type { Conversation, JSONValue, Message, TokenUsage } from './types';
 /**
  * Checks if a message is currently streaming (has the streaming metadata flag).
  */
@@ -13,7 +13,7 @@ export declare function getStreamingMessage(conversation: Conversation): Message
  * Creates a pending/streaming message placeholder and appends it to the conversation.
  * Returns both the updated conversation and the ID of the new streaming message.
  */
-export declare function appendStreamingMessage(conversation: Conversation, role: 'assistant' | 'user', metadata?: Record<string, unknown>, environment?: Partial<ConversationEnvironment>): {
+export declare function appendStreamingMessage(conversation: Conversation, role: 'assistant' | 'user', metadata?: Record<string, JSONValue>, environment?: Partial<ConversationEnvironment>): {
     conversation: Conversation;
     messageId: string;
 };
@@ -28,7 +28,7 @@ export declare function updateStreamingMessage(conversation: Conversation, messa
  */
 export declare function finalizeStreamingMessage(conversation: Conversation, messageId: string, options?: {
     tokenUsage?: TokenUsage;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, JSONValue>;
 }, environment?: Partial<ConversationEnvironment>): Conversation;
 /**
  * Cancels a streaming message by removing it from the conversation.

package/dist/streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKjE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAEnF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,EAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAyBnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACrC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAiCd;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CA4Cd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAqCd"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,YAAY,EACZ,SAAS,EACT,OAAO,EACP,UAAU,EACX,MAAM,SAAS,CAAC;AA4CjB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAEnF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,EAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACpC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA0BnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,EACrC,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CA2Bd;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC,EACD,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CAqCd;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,YAAY,CA8Bd"}

package/dist/types.d.ts

@@ -1,24 +1,55 @@
 import type { MultiModalContent } from '@lasercat/homogenaize';
+/**
+ * Current schema version for serialized conversation data.
+ * Increment when making breaking changes to the schema.
+ */
+export declare const CURRENT_SCHEMA_VERSION = 3;
+/**
+ * JSON-serializable value types.
+ */
+export type JSONPrimitive = string | number | boolean | null;
+export type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+/**
+ * Supported message roles in a conversation.
+ */
 export type MessageRole = 'user' | 'assistant' | 'system' | 'developer' | 'tool-use' | 'tool-result' | 'snapshot';
+/**
+ * Tool call metadata for tool-use messages.
+ */
 export interface ToolCall {
     id: string;
     name: string;
-    arguments: unknown;
+    arguments: JSONValue;
 }
+/**
+ * Tool execution result metadata for tool-result messages.
+ */
 export interface ToolResult {
     callId: string;
     outcome: 'success' | 'error';
-    content: unknown;
+    content: JSONValue;
+    toolCallId?: string | undefined;
+    toolName?: string | undefined;
+    result?: JSONValue | undefined;
+    error?: string | undefined;
 }
+/**
+ * Token usage accounting for a message.
+ */
 export interface TokenUsage {
     prompt: number;
     completion: number;
     total: number;
 }
+/**
+ * Mutable input shape for creating a message.
+ */
 export interface MessageInput {
     role: MessageRole;
     content: string | MultiModalContent[];
-    metadata?: Record<string, unknown> | undefined;
+    metadata?: Record<string, JSONValue> | undefined;
     hidden?: boolean | undefined;
     toolCall?: ToolCall | undefined;
     toolResult?: ToolResult | undefined;
@@ -26,52 +57,44 @@ export interface MessageInput {
     /** Indicates if this message represents goal completion (assistant only) */
     goalCompleted?: boolean | undefined;
 }
-export interface MessageJSON {
-    id: string;
-    role: MessageRole;
-    content: string | MultiModalContent[];
-    position: number;
-    createdAt: string;
-    metadata: Record<string, unknown>;
-    hidden: boolean;
-    toolCall?: ToolCall | undefined;
-    toolResult?: ToolResult | undefined;
-    tokenUsage?: TokenUsage | undefined;
-    /** Indicates if this message represents goal completion (assistant only) */
-    goalCompleted?: boolean | undefined;
-}
+/**
+ * Immutable message shape exposed by the library.
+ */
 export interface Message {
     id: string;
     role: MessageRole;
     content: string | ReadonlyArray<MultiModalContent>;
     position: number;
     createdAt: string;
-    metadata: Readonly<Record<string, unknown>>;
+    metadata: Readonly<Record<string, JSONValue>>;
     hidden: boolean;
     toolCall?: Readonly<ToolCall> | undefined;
     toolResult?: Readonly<ToolResult> | undefined;
     tokenUsage?: Readonly<TokenUsage> | undefined;
-    /** Indicates if this message represents goal completion (assistant only) */
+}
+/**
+ * Assistant-only message shape with optional goal completion metadata.
+ */
+export interface AssistantMessage extends Message {
+    role: 'assistant';
+    /** Indicates if this message represents goal completion */
     goalCompleted?: boolean | undefined;
 }
+/**
+ * Status values for a conversation lifecycle.
+ */
 export type ConversationStatus = 'active' | 'archived' | 'deleted';
-export interface ConversationJSON {
-    id: string;
-    title?: string | undefined;
-    status: ConversationStatus;
-    metadata: Record<string, unknown>;
-    tags: string[];
-    messages: MessageJSON[];
-    createdAt: string;
-    updatedAt: string;
-}
+/**
+ * Immutable conversation state.
+ */
 export interface Conversation {
+    schemaVersion: number;
     id: string;
     title?: string | undefined;
     status: ConversationStatus;
-    metadata: Readonly<Record<string, unknown>>;
-    tags: ReadonlyArray<string>;
-    messages: ReadonlyArray<Message>;
+    metadata: Readonly<Record<string, JSONValue>>;
+    ids: ReadonlyArray<string>;
+    messages: Readonly<Record<string, Message>>;
     createdAt: string;
     updatedAt: string;
 }
@@ -86,15 +109,62 @@ export type MessagePlugin = (input: MessageInput) => MessageInput;
 /**
  * Serialized form of a single node in the conversation history tree.
  */
-export interface HistoryNodeJSON {
-    conversation: ConversationJSON;
-    children: HistoryNodeJSON[];
+export interface HistoryNodeSnapshot {
+    conversation: Conversation;
+    children: HistoryNodeSnapshot[];
 }
 /**
  * Serialized form of the entire conversation history.
  */
-export interface ConversationHistoryJSON {
-    root: HistoryNodeJSON;
+export interface ConversationHistorySnapshot {
+    root: HistoryNodeSnapshot;
     currentPath: number[];
 }
+/**
+ * Base options for all export operations.
+ */
+export interface ExportOptions {
+    /**
+     * When true, strips transient metadata (keys starting with '_').
+     * @default false
+     */
+    stripTransient?: boolean;
+    /**
+     * When false, hidden messages are omitted from export output.
+     * @default true
+     */
+    includeHidden?: boolean;
+    /**
+     * When true, hidden message content is replaced with a redacted placeholder.
+     * Only applies when includeHidden is true.
+     * @default false
+     */
+    redactHiddenContent?: boolean;
+    /**
+     * Placeholder used when redacting tool or hidden content.
+     * @default "[REDACTED]"
+     */
+    redactedPlaceholder?: string;
+    /**
+     * When true, redacts tool call arguments with '[REDACTED]'.
+     * @default false
+     */
+    redactToolArguments?: boolean;
+    /**
+     * When true, redacts tool result content with '[REDACTED]'.
+     * @default false
+     */
+    redactToolResults?: boolean;
+}
+/**
+ * Options for exporting to markdown format.
+ */
+export interface ToMarkdownOptions extends ExportOptions {
+    /**
+     * When true, includes YAML frontmatter with full metadata for lossless round-trip.
+     * Headers include message ID: `### Role (msg-id)`
+     * @default false
+     */
+    includeMetadata?: boolean;
+}
 //# sourceMappingURL=types.d.ts.map