conversationalist 0.0.9 → 0.0.11

package/dist/conversation/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/conversation/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,IAAI,eAAe,EAE3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,eAAe,EAAE,CAqB5E"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/conversation/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,IAAI,eAAe,EAE3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,YAAY,GAAG,eAAe,EAAE,CAsB5E"}

package/dist/conversation/validation.d.ts

@@ -0,0 +1,8 @@
+import type { Conversation } from '../types';
+/**
+ * Ensures a conversation conforms to the schema (JSON-safe) and integrity rules.
+ * Internal helper for public API enforcement points.
+ */
+export declare function assertConversationSafe(conversation: Conversation): void;
+export declare function ensureConversationSafe(conversation: Conversation): Conversation;
+//# sourceMappingURL=validation.d.ts.map

package/dist/conversation/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/conversation/validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CASvE;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,CAG/E"}

package/dist/errors.d.ts

@@ -1,7 +1,7 @@
 /**
  * Error codes for Conversationalist errors (kebab-case with `error:` prefix).
  */
-export type ConversationalistErrorCode = 'error:locked' | 'error:invalid-input' | 'error:invalid-position' | 'error:invalid-tool-reference' | 'error:duplicate-id' | 'error:not-found' | 'error:serialization' | 'error:validation';
+export type ConversationalistErrorCode = 'error:locked' | 'error:invalid-input' | 'error:invalid-position' | 'error:invalid-tool-reference' | 'error:duplicate-id' | 'error:not-found' | 'error:serialization' | 'error:validation' | 'error:integrity';
 /**
  * Base error class for all Conversationalist errors.
  *
@@ -64,4 +64,9 @@ export declare function createSerializationError(message: string, cause?: Error)
  * Thrown when data validation fails (e.g., Zod schema validation).
  */
 export declare function createValidationError(message: string, context?: Record<string, unknown>, cause?: Error): ConversationalistError;
+/**
+ * Creates an integrity error (ERR_INTEGRITY).
+ * Thrown when conversation invariants are violated.
+ */
+export declare function createIntegrityError(message: string, context?: Record<string, unknown>): ConversationalistError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,cAAc,GACd,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAE1C,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvD,gCAAgC;IAChC,SAAkB,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAG1C,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;KAC3B;IAcH;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAa3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,sBAAsB,CAMhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,sBAAsB,CAMxB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAMtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAMzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAQtE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GACZ,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,CAAC,EAAE,KAAK,GACZ,sBAAsB,CAExB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,cAAc,GACd,qBAAqB,GACrB,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,GACpB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAE1C,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEvD,gCAAgC;IAChC,SAAkB,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAG1C,IAAI,EAAE,0BAA0B,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;KAC3B;IAcH;;OAEG;IACH,gBAAgB,IAAI,MAAM;CAa3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,sBAAsB,CAMhF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,sBAAsB,CAMxB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAMtF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAMzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,CAQtE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GACZ,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,CAAC,EAAE,KAAK,GACZ,sBAAsB,CAExB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,sBAAsB,CAExB"}

package/dist/export/index.js

@@ -3501,6 +3501,250 @@ function normalizeLineEndings(text) {
 // src/utilities/markdown.ts
 var import_gray_matter = __toESM(require_gray_matter(), 1);
 
+// src/errors.ts
+class ConversationalistError extends Error {
+  code;
+  context;
+  cause;
+  constructor(code, message, options2) {
+    super(message);
+    this.name = "ConversationalistError";
+    this.code = code;
+    this.context = options2?.context;
+    this.cause = options2?.cause;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, ConversationalistError);
+    }
+  }
+  toDetailedString() {
+    const parts = [`[${this.code}] ${this.message}`];
+    if (this.context && Object.keys(this.context).length > 0) {
+      parts.push(`Context: ${JSON.stringify(this.context, null, 2)}`);
+    }
+    if (this.cause) {
+      parts.push(`Caused by: ${this.cause.message}`);
+    }
+    return parts.join(`
+`);
+  }
+}
+function createValidationError(message, context, cause) {
+  return new ConversationalistError("error:validation", message, { context, cause });
+}
+function createIntegrityError(message, context) {
+  return new ConversationalistError("error:integrity", message, { context });
+}
+
+// src/schemas.ts
+import { z } from "zod";
+var isPlainObject = (value) => {
+  if (!value || typeof value !== "object")
+    return false;
+  const prototype = Reflect.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+};
+function toMultiModalContent(value) {
+  const result = { type: value.type };
+  if (value.text !== undefined)
+    result.text = value.text;
+  if (value.url !== undefined)
+    result.url = value.url;
+  if (value.mimeType !== undefined)
+    result.mimeType = value.mimeType;
+  return result;
+}
+var jsonValueSchema = z.lazy(() => {
+  const jsonObjectSchema = z.preprocess((value, ctx) => {
+    if (!isPlainObject(value)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "expected a plain object"
+      });
+      return z.NEVER;
+    }
+    return value;
+  }, z.record(z.string(), jsonValueSchema));
+  return z.union([
+    z.string(),
+    z.number().refine((value) => Number.isFinite(value), {
+      message: "expected a finite number"
+    }),
+    z.boolean(),
+    z.null(),
+    z.array(jsonValueSchema),
+    jsonObjectSchema
+  ]);
+});
+var multiModalContentSchema = z.discriminatedUnion("type", [
+  z.object({
+    type: z.literal("text"),
+    text: z.string()
+  }),
+  z.object({
+    type: z.literal("image"),
+    url: z.string().url(),
+    mimeType: z.string().optional(),
+    text: z.string().optional()
+  })
+]).transform(toMultiModalContent);
+var messageRoleSchema = z.enum([
+  "user",
+  "assistant",
+  "system",
+  "developer",
+  "tool-use",
+  "tool-result",
+  "snapshot"
+]);
+var toolCallSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  arguments: jsonValueSchema
+}).strict();
+var toolResultSchema = z.object({
+  callId: z.string(),
+  outcome: z.enum(["success", "error"]),
+  content: jsonValueSchema
+}).strict();
+var tokenUsageSchema = z.object({
+  prompt: z.number().int().min(0),
+  completion: z.number().int().min(0),
+  total: z.number().int().min(0)
+});
+var messageInputSchema = z.object({
+  role: messageRoleSchema,
+  content: z.union([z.string(), z.array(multiModalContentSchema)]),
+  metadata: z.record(z.string(), jsonValueSchema).optional(),
+  hidden: z.boolean().optional(),
+  toolCall: toolCallSchema.optional(),
+  toolResult: toolResultSchema.optional(),
+  tokenUsage: tokenUsageSchema.optional(),
+  goalCompleted: z.boolean().optional()
+}).strict();
+var messageSchema = z.object({
+  id: z.string(),
+  role: messageRoleSchema,
+  content: z.union([z.string(), z.array(multiModalContentSchema)]),
+  position: z.number().int().min(0),
+  createdAt: z.string(),
+  metadata: z.record(z.string(), jsonValueSchema),
+  hidden: z.boolean(),
+  toolCall: toolCallSchema.optional(),
+  toolResult: toolResultSchema.optional(),
+  tokenUsage: tokenUsageSchema.optional(),
+  goalCompleted: z.boolean().optional()
+}).strict();
+var conversationStatusSchema = z.enum([
+  "active",
+  "archived",
+  "deleted"
+]);
+var conversationShape = {
+  schemaVersion: z.number().int().min(1),
+  id: z.string(),
+  title: z.string().optional(),
+  status: conversationStatusSchema,
+  metadata: z.record(z.string(), jsonValueSchema),
+  ids: z.array(z.string()),
+  messages: z.record(z.string(), messageSchema),
+  createdAt: z.string(),
+  updatedAt: z.string()
+};
+var conversationSchema = z.object(conversationShape).strict();
+
+// src/conversation/integrity.ts
+function validateConversationIntegrity(conversation) {
+  const issues = [];
+  const seenIds = new Set;
+  conversation.ids.forEach((id, index) => {
+    if (seenIds.has(id)) {
+      issues.push({
+        code: "integrity:duplicate-message-id",
+        message: `duplicate message id in ids: ${id}`,
+        data: { id, position: index }
+      });
+    } else {
+      seenIds.add(id);
+    }
+    if (!conversation.messages[id]) {
+      issues.push({
+        code: "integrity:missing-message",
+        message: `missing message for id ${id}`,
+        data: { id, position: index }
+      });
+    }
+  });
+  for (const id of Object.keys(conversation.messages)) {
+    if (!seenIds.has(id)) {
+      issues.push({
+        code: "integrity:unlisted-message",
+        message: `message ${id} is not listed in ids`,
+        data: { id }
+      });
+    }
+  }
+  const toolUses = new Map;
+  conversation.ids.forEach((id, index) => {
+    const message = conversation.messages[id];
+    if (!message)
+      return;
+    if (message.role === "tool-use" && message.toolCall) {
+      if (toolUses.has(message.toolCall.id)) {
+        issues.push({
+          code: "integrity:duplicate-tool-call",
+          message: `duplicate toolCall.id ${message.toolCall.id}`,
+          data: { toolCallId: message.toolCall.id, messageId: message.id }
+        });
+      } else {
+        toolUses.set(message.toolCall.id, { position: index, messageId: message.id });
+      }
+    }
+  });
+  conversation.ids.forEach((id, index) => {
+    const message = conversation.messages[id];
+    if (!message)
+      return;
+    if (message.role === "tool-result" && message.toolResult) {
+      const toolUse = toolUses.get(message.toolResult.callId);
+      if (!toolUse) {
+        issues.push({
+          code: "integrity:orphan-tool-result",
+          message: `tool-result references missing tool-use ${message.toolResult.callId}`,
+          data: { callId: message.toolResult.callId, messageId: message.id }
+        });
+      } else if (toolUse.position >= index) {
+        issues.push({
+          code: "integrity:tool-result-before-call",
+          message: `tool-result ${message.toolResult.callId} occurs before tool-use`,
+          data: {
+            callId: message.toolResult.callId,
+            messageId: message.id,
+            toolUseMessageId: toolUse.messageId
+          }
+        });
+      }
+    }
+  });
+  return issues;
+}
+function assertConversationIntegrity(conversation) {
+  const issues = validateConversationIntegrity(conversation);
+  if (issues.length === 0)
+    return;
+  throw createIntegrityError("conversation integrity check failed", { issues });
+}
+
+// src/conversation/validation.ts
+function assertConversationSafe(conversation) {
+  const parsed = conversationSchema.safeParse(conversation);
+  if (!parsed.success) {
+    throw createValidationError("conversation failed schema validation", {
+      issues: parsed.error.issues
+    });
+  }
+  assertConversationIntegrity(conversation);
+}
+
 // src/multi-modal.ts
 function copyMultiModalContent(item) {
   if (item.type === "text") {
@@ -3565,14 +3809,7 @@ function copyToolResult(toolResult) {
   return { ...toolResult };
 }
 function redactToolResult(toolResult, placeholder) {
-  const result = { ...toolResult, content: placeholder };
-  if (result.result !== undefined) {
-    result.result = placeholder;
-  }
-  if (result.error !== undefined) {
-    result.error = placeholder;
-  }
-  return result;
+  return { ...toolResult, content: placeholder };
 }
 
 // src/utilities/transient.ts
@@ -3599,7 +3836,6 @@ var ROLE_LABELS = {
   "tool-result": "Tool Result",
   snapshot: "Snapshot"
 };
-var ROLE_DISPLAY_NAMES = ROLE_LABELS;
 var DEFAULT_REDACTED_PLACEHOLDER = "[REDACTED]";
 function resolveMarkdownOptions(options2 = {}) {
   return {
@@ -3676,6 +3912,7 @@ function formatMessageContent(message) {
 `);
 }
 function toMarkdown(conversation, options2 = {}) {
+  assertConversationSafe(conversation);
   const resolved = resolveMarkdownOptions(options2);
   const prepared = prepareConversationForMarkdown(conversation, resolved);
   if (resolved.includeMetadata) {
@@ -3686,7 +3923,7 @@ function toMarkdown(conversation, options2 = {}) {
 function toMarkdownSimple(conversation) {
   const sections = [];
   for (const message of getOrderedMessages(conversation)) {
-    const roleName = ROLE_DISPLAY_NAMES[message.role];
+    const roleName = ROLE_LABELS[message.role];
     const header = `### ${roleName}`;
     const content = formatMessageContent(message);
     sections.push(`${header}
@@ -3737,7 +3974,7 @@ function toMarkdownWithMetadata(conversation, _options) {
   }
   const messageSections = [];
   for (const message of getOrderedMessages(conversation)) {
-    const roleName = ROLE_DISPLAY_NAMES[message.role];
+    const roleName = ROLE_LABELS[message.role];
     const header = `### ${roleName} (${message.id})`;
     const content = formatMessageContent(message);
     messageSections.push(`${header}
@@ -3759,4 +3996,4 @@ export {
   exportMarkdown
 };
 
-//# debugId=EA141CBA5FF5FB1D64756E2164756E21
+//# debugId=23462BBCDD76F94964756E2164756E21