@canonmsg/backend-contracts 1.8.0 → 1.8.1

package/dist/bridgeLocal.d.ts

@@ -519,24 +519,24 @@ export declare const BRIDGE_LOCAL_METHODS: {
                 behavior: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 hasUnread: z.ZodOptional<z.ZodBoolean>;
                 lastMessage: z.ZodNullable<z.ZodObject<{
-                    text: z.ZodString;
+                    text: z.ZodNullable<z.ZodString>;
                     messageId: z.ZodOptional<z.ZodString>;
-                    senderId: z.ZodString;
-                    senderType: z.ZodEnum<{
+                    senderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    senderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                         human: "human";
                         ai_agent: "ai_agent";
-                    }>;
-                    contentType: z.ZodOptional<z.ZodEnum<{
+                    }>>>;
+                    contentType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                         file: "file";
                         image: "image";
                         audio: "audio";
                         video: "video";
                         text: "text";
                         contact_card: "contact_card";
-                    }>>;
-                    timestamp: z.ZodString;
+                    }>>>;
+                    timestamp: z.ZodNullable<z.ZodString>;
                 }, z.core.$loose>>;
-                createdAt: z.ZodOptional<z.ZodString>;
+                createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>;
         }, z.core.$strip>;
     };

package/dist/cjs/hitl.js

@@ -1,171 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HitlPendingSchema = exports.HitlResolutionSchema = exports.HitlRequestAcceptedSchema = exports.HitlCardOutcomeRecordSchema = exports.HitlCardReplyRecordSchema = exports.HitlCardRequestRecordSchema = exports.HitlInputOutcomeRecordSchema = exports.HitlInputReplyRecordSchema = exports.HitlInputRequestRecordSchema = exports.HitlInputAnswersSchema = exports.HitlInputQuestionSchema = exports.HitlInputKindSchema = exports.HitlApprovalOutcomeRecordSchema = exports.HitlApprovalReplyRecordSchema = exports.HitlApprovalRequestRecordSchema = exports.HitlSessionRuleSchema = exports.HitlApprovalDetailSchema = exports.HitlApprovalCategorySchema = exports.HitlApprovalRiskSchema = exports.HitlResolutionStatusSchema = exports.HitlRequestKindSchema = void 0;
-// Wire contract v1 — HITL (human-in-the-loop) request / resolution records.
-//
-// HITL is durable state, not a held request (bridge-local-api.md): the pending
-// request is a persisted record (message metadata + RTDB node with expiresAt),
-// and the resolution arrives later. These schemas ground the three record
-// families as core's hosts publish/consume them today:
-//   approval — approval_request / approval_reply / approval_outcome
-//   input    — runtime_input_request / runtime_input_reply / runtime_input_outcome
-//   card     — runtime_card_request / runtime_card_reply / runtime_card_outcome
-// plus the unified bridge-level resolution record (§C6 onHitlResolved).
-const zod_1 = require("zod");
-const runtimeCardFields_js_1 = require("./runtimeCardFields.js");
-exports.HitlRequestKindSchema = zod_1.z.enum(['approval', 'input', 'card']);
-exports.HitlResolutionStatusSchema = zod_1.z.enum(['submitted', 'cancelled', 'timeout']);
-// ── Approval records ───────────────────────────────────────────────────
-exports.HitlApprovalRiskSchema = zod_1.z.enum(['low', 'normal', 'high', 'destructive']);
-exports.HitlApprovalCategorySchema = zod_1.z.enum([
-    'command',
-    'file',
-    'network',
-    'browser',
-    'mcp',
-    'plugin',
-    'canon',
-    'tool',
-]);
-exports.HitlApprovalDetailSchema = zod_1.z.object({
-    label: zod_1.z.string(),
-    value: zod_1.z.string(),
-    monospace: zod_1.z.boolean().optional(),
-});
-exports.HitlSessionRuleSchema = zod_1.z.object({
-    type: zod_1.z.enum(['approve-all', 'approve-tool', 'deny-tool']),
-    toolPattern: zod_1.z.string().optional(),
-    expiresAt: zod_1.z.string().nullable().optional(),
-});
-exports.HitlApprovalRequestRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('approval_request'),
-    approvalId: zod_1.z.string(),
-    responseUserId: zod_1.z.string().optional(),
-    toolName: zod_1.z.string(),
-    /** Pre-computed, redacted summary — raw tool input is never stored. */
-    toolSummary: zod_1.z.string(),
-    category: exports.HitlApprovalCategorySchema.optional(),
-    risk: exports.HitlApprovalRiskSchema.optional(),
-    riskLevel: zod_1.z.enum(['normal', 'destructive']).optional(),
-    runtimeId: zod_1.z.string().optional(),
-    turnId: zod_1.z.string().optional(),
-    /** Native runtime correlation handles — opaque pass-through. */
-    native: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    details: zod_1.z.array(exports.HitlApprovalDetailSchema).optional(),
-    /** File-change preview (CanonUnifiedDiff) — opaque pass-through. */
-    diff: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    expiresAt: zod_1.z.string(),
-});
-exports.HitlApprovalReplyRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('approval_reply'),
-    approvalId: zod_1.z.string(),
-    decision: zod_1.z.enum(['allow', 'deny']),
-    sessionRule: exports.HitlSessionRuleSchema.optional(),
-});
-exports.HitlApprovalOutcomeRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('approval_outcome'),
-    approvalId: zod_1.z.string().optional(),
-    decision: zod_1.z.enum(['allow', 'deny']).optional(),
-    reason: zod_1.z.enum(['replied', 'timeout', 'session-rule']).optional(),
-});
-// ── Input records ──────────────────────────────────────────────────────
-exports.HitlInputKindSchema = zod_1.z.enum(['clarify', 'sudo', 'secret']);
-exports.HitlInputQuestionSchema = zod_1.z.object({
-    id: zod_1.z.string(),
-    question: zod_1.z.string(),
-    header: zod_1.z.string().optional(),
-    choices: zod_1.z.array(runtimeCardFields_js_1.RuntimeCardFieldChoiceSchema).optional(),
-    allowOther: zod_1.z.boolean().optional(),
-    isSecret: zod_1.z.boolean().optional(),
-    multiSelect: zod_1.z.boolean().optional(),
-});
-/** questionId → selected/typed answers. */
-exports.HitlInputAnswersSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.object({ answers: zod_1.z.array(zod_1.z.string()) }));
-exports.HitlInputRequestRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_input_request'),
-    inputId: zod_1.z.string(),
-    responseUserId: zod_1.z.string().optional(),
-    kind: exports.HitlInputKindSchema,
-    prompt: zod_1.z.string(),
-    title: zod_1.z.string().optional(),
-    choices: zod_1.z.array(runtimeCardFields_js_1.RuntimeCardFieldChoiceSchema).optional(),
-    questions: zod_1.z.array(exports.HitlInputQuestionSchema).optional(),
-    secretName: zod_1.z.string().optional(),
-    native: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    expiresAt: zod_1.z.string(),
-    sensitive: zod_1.z.boolean().optional(),
-});
-exports.HitlInputReplyRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_input_reply'),
-    inputId: zod_1.z.string(),
-    kind: exports.HitlInputKindSchema.optional(),
-    status: zod_1.z.enum(['submitted', 'cancelled']),
-    answerSummary: zod_1.z.string().optional(),
-    answersSummary: zod_1.z.string().optional(),
-    sensitive: zod_1.z.boolean().optional(),
-});
-exports.HitlInputOutcomeRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_input_outcome'),
-    inputId: zod_1.z.string(),
-    kind: exports.HitlInputKindSchema.optional(),
-    status: exports.HitlResolutionStatusSchema,
-    reason: zod_1.z.enum(['submitted', 'cancelled', 'timeout', 'expired', 'interrupted']).optional(),
-});
-// ── Card records ───────────────────────────────────────────────────────
-exports.HitlCardRequestRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_card_request'),
-    cardId: zod_1.z.string(),
-    cardKind: zod_1.z.string(),
-    schemaVersion: zod_1.z.literal('canon.card.v1'),
-    fallbackText: zod_1.z.string(),
-    responseUserId: zod_1.z.string().optional(),
-    expiresAt: zod_1.z.string(),
-    runtimeId: zod_1.z.string().optional(),
-    turnId: zod_1.z.string().optional(),
-    native: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-    /** True when the card carries an actions block (agent waits for a response). */
-    interactive: zod_1.z.boolean().optional(),
-    /** RuntimeCardPreview — opaque pass-through. */
-    cardPreview: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
-    turnSemantics: zod_1.z.literal('control'),
-    replyBehavior: zod_1.z.literal('suppress_auto_reply'),
-});
-exports.HitlCardReplyRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_card_reply'),
-    cardId: zod_1.z.string(),
-    status: zod_1.z.enum(['submitted', 'cancelled']),
-    actionId: zod_1.z.string().optional(),
-    answerSummary: zod_1.z.string().optional(),
-    sensitive: zod_1.z.boolean().optional(),
-    turnSemantics: zod_1.z.literal('control'),
-    replyBehavior: zod_1.z.literal('suppress_auto_reply'),
-});
-exports.HitlCardOutcomeRecordSchema = zod_1.z.looseObject({
-    type: zod_1.z.literal('runtime_card_outcome'),
-    cardId: zod_1.z.string(),
-    status: exports.HitlResolutionStatusSchema,
-    reason: zod_1.z.enum(['submitted', 'cancelled', 'timeout', 'expired', 'interrupted']).optional(),
-    turnSemantics: zod_1.z.literal('control'),
-    replyBehavior: zod_1.z.literal('suppress_auto_reply'),
-});
-// ── Unified bridge-level records (bridge-local-api §B7/§C6) ────────────
-/** Immediate result of requestApproval/requestInput/requestCard. */
-exports.HitlRequestAcceptedSchema = zod_1.z.object({
-    requestId: zod_1.z.string(),
-    expiresAt: zod_1.z.string(),
-});
-/** `onHitlResolved` — matches an earlier requestId. */
-exports.HitlResolutionSchema = zod_1.z.object({
-    requestId: zod_1.z.string(),
-    kind: exports.HitlRequestKindSchema.optional(),
-    status: exports.HitlResolutionStatusSchema,
-    /** Kind-specific answer payload (decision / answers / card action values). */
-    answer: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-});
-/** `onHitlPending` — replayed on reconnect for still-open requests. */
-exports.HitlPendingSchema = zod_1.z.object({
-    requestId: zod_1.z.string(),
-    kind: exports.HitlRequestKindSchema,
-    conversationId: zod_1.z.string(),
-    expiresAt: zod_1.z.string(),
-});

package/dist/cjs/restEndpoints.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UploadMediaResponseSchema = exports.UploadMediaRequestSchema = exports.SetStreamingRequestSchema = exports.SetTypingRequestSchema = exports.ResolveAdmissionResponseSchema = exports.ResolveAdmissionRequestSchema = exports.ContactsResponseSchema = exports.CreateContactRequestResponseSchema = exports.CreateContactRequestRequestSchema = exports.CreateConversationResponseSchema = exports.CreateConversationRequestSchema = exports.MessagesPageResponseSchema = exports.GetMessagesQuerySchema = exports.ConversationsResponseSchema = exports.UpdateDispositionRequestSchema = exports.MarkReadResponseSchema = exports.DeleteMessageResponseSchema = exports.ForwardMessageResponseSchema = exports.ForwardMessageRequestSchema = exports.ReactResponseSchema = exports.ReactRequestSchema = exports.SendMessageResponseSchema = exports.SendMessageRequestSchema = exports.RestSessionSelectionSchema = exports.RestContactSchema = exports.RestConversationSchema = exports.RestMessageSchema = exports.RestOkResponseSchema = void 0;
+exports.UploadMediaResponseSchema = exports.UploadMediaRequestSchema = exports.SetStreamingRequestSchema = exports.SetTypingRequestSchema = exports.ResolveAdmissionResponseSchema = exports.ResolveAdmissionRequestSchema = exports.ContactsResponseSchema = exports.CreateContactRequestResponseSchema = exports.CreateContactRequestRequestSchema = exports.CreateConversationResponseSchema = exports.CreateConversationRequestSchema = exports.MessagesPageResponseSchema = exports.GetMessagesQuerySchema = exports.ConversationsResponseSchema = exports.UpdateDispositionRequestSchema = exports.MarkReadResponseSchema = exports.DeleteMessageResponseSchema = exports.ForwardMessageResponseSchema = exports.ForwardMessageRequestSchema = exports.ReactResponseSchema = exports.ReactRequestSchema = exports.SendMessageResponseSchema = exports.SendMessageRequestSchema = exports.RestSessionSelectionSchema = exports.RestContactSchema = exports.RestConversationSchema = exports.RestConversationLastMessageSchema = exports.RestMessageSchema = exports.RestOkResponseSchema = void 0;
 // Wire contract v1 — request/response schemas for the agent-facing "Canon op"
 // REST surface the bridge proxies (bridge-local-api.md §B).
 //
@@ -20,6 +20,30 @@ exports.RestOkResponseSchema = zod_1.z.looseObject({
 exports.RestMessageSchema = message_js_1.SerializedMessageSchema.extend({
     deleted: zod_1.z.boolean().optional(),
 });
+/**
+ * STRICT WRITES, TOLERANT READS: this is a READ schema over live production
+ * data, so it must describe what Firestore actually holds — not what today's
+ * writers produce. The GET /conversations serializer
+ * (functions/src/api/getConversations.ts) passes `lastMessage` fields through
+ * from the conversation doc, and legacy rows (pre-refactor writes,
+ * deleted-message repair) hold explicit nulls:
+ * - `text` is serialized `?? null` and `timestamp` as
+ *   `?.toDate?.()?.toISOString() ?? null` — both emit null by construction.
+ * - `senderId` / `senderType` / `contentType` are raw pass-throughs; live
+ *   rows exist with all three null (the getConversations "ghost fix" comment
+ *   acknowledges null senderId).
+ * - conversation `createdAt` is also serialized `?? null`.
+ * Writers (onMessageCreated / deletedMessageRepair) stay strict — they always
+ * produce the full shape; only the read contract admits the legacy nulls.
+ */
+exports.RestConversationLastMessageSchema = zod_1.z.looseObject({
+    text: zod_1.z.string().nullable(),
+    messageId: zod_1.z.string().optional(),
+    senderId: zod_1.z.string().nullable().optional(),
+    senderType: zod_1.z.enum(['human', 'ai_agent']).nullable().optional(),
+    contentType: message_js_1.SerializedContentTypeSchema.nullable().optional(),
+    timestamp: zod_1.z.string().nullable(),
+});
 exports.RestConversationSchema = zod_1.z.looseObject({
     id: zod_1.z.string(),
     type: zod_1.z.enum(['direct', 'group']),
@@ -30,15 +54,8 @@ exports.RestConversationSchema = zod_1.z.looseObject({
     /** Resolved agent behavior policy — opaque pass-through. */
     behavior: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     hasUnread: zod_1.z.boolean().optional(),
-    lastMessage: zod_1.z.looseObject({
-        text: zod_1.z.string(),
-        messageId: zod_1.z.string().optional(),
-        senderId: zod_1.z.string(),
-        senderType: zod_1.z.enum(['human', 'ai_agent']),
-        contentType: message_js_1.SerializedContentTypeSchema.optional(),
-        timestamp: zod_1.z.string(),
-    }).nullable(),
-    createdAt: zod_1.z.string().optional(),
+    lastMessage: exports.RestConversationLastMessageSchema.nullable(),
+    createdAt: zod_1.z.string().nullable().optional(),
 });
 exports.RestContactSchema = zod_1.z.object({
     id: zod_1.z.string(),

package/dist/restEndpoints.d.ts

@@ -78,6 +78,41 @@ export declare const RestMessageSchema: z.ZodObject<{
     deleted: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type RestMessage = z.infer<typeof RestMessageSchema>;
+/**
+ * STRICT WRITES, TOLERANT READS: this is a READ schema over live production
+ * data, so it must describe what Firestore actually holds — not what today's
+ * writers produce. The GET /conversations serializer
+ * (functions/src/api/getConversations.ts) passes `lastMessage` fields through
+ * from the conversation doc, and legacy rows (pre-refactor writes,
+ * deleted-message repair) hold explicit nulls:
+ * - `text` is serialized `?? null` and `timestamp` as
+ *   `?.toDate?.()?.toISOString() ?? null` — both emit null by construction.
+ * - `senderId` / `senderType` / `contentType` are raw pass-throughs; live
+ *   rows exist with all three null (the getConversations "ghost fix" comment
+ *   acknowledges null senderId).
+ * - conversation `createdAt` is also serialized `?? null`.
+ * Writers (onMessageCreated / deletedMessageRepair) stay strict — they always
+ * produce the full shape; only the read contract admits the legacy nulls.
+ */
+export declare const RestConversationLastMessageSchema: z.ZodObject<{
+    text: z.ZodNullable<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    senderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    senderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        human: "human";
+        ai_agent: "ai_agent";
+    }>>>;
+    contentType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        file: "file";
+        image: "image";
+        audio: "audio";
+        video: "video";
+        text: "text";
+        contact_card: "contact_card";
+    }>>>;
+    timestamp: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>;
+export type RestConversationLastMessage = z.infer<typeof RestConversationLastMessageSchema>;
 export declare const RestConversationSchema: z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
@@ -91,24 +126,24 @@ export declare const RestConversationSchema: z.ZodObject<{
     behavior: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     hasUnread: z.ZodOptional<z.ZodBoolean>;
     lastMessage: z.ZodNullable<z.ZodObject<{
-        text: z.ZodString;
+        text: z.ZodNullable<z.ZodString>;
         messageId: z.ZodOptional<z.ZodString>;
-        senderId: z.ZodString;
-        senderType: z.ZodEnum<{
+        senderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        senderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             human: "human";
             ai_agent: "ai_agent";
-        }>;
-        contentType: z.ZodOptional<z.ZodEnum<{
+        }>>>;
+        contentType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             file: "file";
             image: "image";
             audio: "audio";
             video: "video";
             text: "text";
             contact_card: "contact_card";
-        }>>;
-        timestamp: z.ZodString;
+        }>>>;
+        timestamp: z.ZodNullable<z.ZodString>;
     }, z.core.$loose>>;
-    createdAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>;
 export type RestConversation = z.infer<typeof RestConversationSchema>;
 export declare const RestContactSchema: z.ZodObject<{
@@ -230,24 +265,24 @@ export declare const ConversationsResponseSchema: z.ZodObject<{
         behavior: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         hasUnread: z.ZodOptional<z.ZodBoolean>;
         lastMessage: z.ZodNullable<z.ZodObject<{
-            text: z.ZodString;
+            text: z.ZodNullable<z.ZodString>;
             messageId: z.ZodOptional<z.ZodString>;
-            senderId: z.ZodString;
-            senderType: z.ZodEnum<{
+            senderId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            senderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 human: "human";
                 ai_agent: "ai_agent";
-            }>;
-            contentType: z.ZodOptional<z.ZodEnum<{
+            }>>>;
+            contentType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 file: "file";
                 image: "image";
                 audio: "audio";
                 video: "video";
                 text: "text";
                 contact_card: "contact_card";
-            }>>;
-            timestamp: z.ZodString;
+            }>>>;
+            timestamp: z.ZodNullable<z.ZodString>;
         }, z.core.$loose>>;
-        createdAt: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$loose>>;
 }, z.core.$strip>;
 export type ConversationsResponse = z.infer<typeof ConversationsResponseSchema>;

package/dist/restEndpoints.js

@@ -17,6 +17,30 @@ export const RestOkResponseSchema = z.looseObject({
 export const RestMessageSchema = SerializedMessageSchema.extend({
     deleted: z.boolean().optional(),
 });
+/**
+ * STRICT WRITES, TOLERANT READS: this is a READ schema over live production
+ * data, so it must describe what Firestore actually holds — not what today's
+ * writers produce. The GET /conversations serializer
+ * (functions/src/api/getConversations.ts) passes `lastMessage` fields through
+ * from the conversation doc, and legacy rows (pre-refactor writes,
+ * deleted-message repair) hold explicit nulls:
+ * - `text` is serialized `?? null` and `timestamp` as
+ *   `?.toDate?.()?.toISOString() ?? null` — both emit null by construction.
+ * - `senderId` / `senderType` / `contentType` are raw pass-throughs; live
+ *   rows exist with all three null (the getConversations "ghost fix" comment
+ *   acknowledges null senderId).
+ * - conversation `createdAt` is also serialized `?? null`.
+ * Writers (onMessageCreated / deletedMessageRepair) stay strict — they always
+ * produce the full shape; only the read contract admits the legacy nulls.
+ */
+export const RestConversationLastMessageSchema = z.looseObject({
+    text: z.string().nullable(),
+    messageId: z.string().optional(),
+    senderId: z.string().nullable().optional(),
+    senderType: z.enum(['human', 'ai_agent']).nullable().optional(),
+    contentType: SerializedContentTypeSchema.nullable().optional(),
+    timestamp: z.string().nullable(),
+});
 export const RestConversationSchema = z.looseObject({
     id: z.string(),
     type: z.enum(['direct', 'group']),
@@ -27,15 +51,8 @@ export const RestConversationSchema = z.looseObject({
     /** Resolved agent behavior policy — opaque pass-through. */
     behavior: z.record(z.string(), z.unknown()).optional(),
     hasUnread: z.boolean().optional(),
-    lastMessage: z.looseObject({
-        text: z.string(),
-        messageId: z.string().optional(),
-        senderId: z.string(),
-        senderType: z.enum(['human', 'ai_agent']),
-        contentType: SerializedContentTypeSchema.optional(),
-        timestamp: z.string(),
-    }).nullable(),
-    createdAt: z.string().optional(),
+    lastMessage: RestConversationLastMessageSchema.nullable(),
+    createdAt: z.string().nullable().optional(),
 });
 export const RestContactSchema = z.object({
     id: z.string(),

package/dist/schemas/conversations-response.schema.json

@@ -63,40 +63,73 @@
                 "type": "object",
                 "properties": {
                   "text": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
                   },
                   "messageId": {
                     "type": "string"
                   },
                   "senderId": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
                   },
                   "senderType": {
-                    "type": "string",
-                    "enum": [
-                      "human",
-                      "ai_agent"
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "human",
+                          "ai_agent"
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
                     ]
                   },
                   "contentType": {
-                    "type": "string",
-                    "enum": [
-                      "text",
-                      "image",
-                      "audio",
-                      "video",
-                      "file",
-                      "contact_card"
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "enum": [
+                          "text",
+                          "image",
+                          "audio",
+                          "video",
+                          "file",
+                          "contact_card"
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
                     ]
                   },
                   "timestamp": {
-                    "type": "string"
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
                   }
                 },
                 "required": [
                   "text",
-                  "senderId",
-                  "senderType",
                   "timestamp"
                 ],
                 "additionalProperties": {}
@@ -107,7 +140,14 @@
             ]
           },
           "createdAt": {
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "required": [

package/dist/schemas/rest-conversation-last-message.schema.json

@@ -0,0 +1,77 @@
+{
+  "$id": "canon:RestConversationLastMessageSchema",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "text": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "messageId": {
+      "type": "string"
+    },
+    "senderId": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "senderType": {
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "human",
+            "ai_agent"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "contentType": {
+      "anyOf": [
+        {
+          "type": "string",
+          "enum": [
+            "text",
+            "image",
+            "audio",
+            "video",
+            "file",
+            "contact_card"
+          ]
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "timestamp": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "text",
+    "timestamp"
+  ],
+  "additionalProperties": {}
+}

package/dist/schemas/rest-conversation.schema.json

@@ -58,40 +58,73 @@
           "type": "object",
           "properties": {
             "text": {
-              "type": "string"
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             },
             "messageId": {
               "type": "string"
             },
             "senderId": {
-              "type": "string"
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             },
             "senderType": {
-              "type": "string",
-              "enum": [
-                "human",
-                "ai_agent"
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "human",
+                    "ai_agent"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "contentType": {
-              "type": "string",
-              "enum": [
-                "text",
-                "image",
-                "audio",
-                "video",
-                "file",
-                "contact_card"
+              "anyOf": [
+                {
+                  "type": "string",
+                  "enum": [
+                    "text",
+                    "image",
+                    "audio",
+                    "video",
+                    "file",
+                    "contact_card"
+                  ]
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "timestamp": {
-              "type": "string"
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
             "text",
-            "senderId",
-            "senderType",
             "timestamp"
           ],
           "additionalProperties": {}
@@ -102,7 +135,14 @@
       ]
     },
     "createdAt": {
-      "type": "string"
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
     }
   },
   "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/backend-contracts",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Canon backend contract helpers shared by Functions and stream-service",
   "type": "module",
   "main": "dist/cjs/index.js",