@canonmsg/backend-contracts 1.8.1 → 2.0.0

package/dist/index.js

@@ -5,11 +5,3 @@ export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';
 export * from './agentBehaviorPolicy.js';
 export * from './contactRequest.js';
-export * from './sseEvents.js';
-export * from './controlSignals.js';
-export * from './hitl.js';
-export * from './inboundFrame.js';
-export * from './restEndpoints.js';
-export * from './sendContextual.js';
-export * from './bridgeLocal.js';
-export * from './endpointRegistry.js';

package/dist/media.d.ts

@@ -1,27 +1,14 @@
-import { z } from 'zod';
-export declare const MediaAttachmentKindSchema: z.ZodEnum<{
-    file: "file";
-    image: "image";
-    audio: "audio";
-    video: "video";
-}>;
-export type MediaAttachmentKind = z.infer<typeof MediaAttachmentKindSchema>;
-export declare const MediaAttachmentSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        file: "file";
-        image: "image";
-        audio: "audio";
-        video: "video";
-    }>;
-    url: z.ZodString;
-    mimeType: z.ZodOptional<z.ZodString>;
-    fileName: z.ZodOptional<z.ZodString>;
-    sizeBytes: z.ZodOptional<z.ZodNumber>;
-    width: z.ZodOptional<z.ZodNumber>;
-    height: z.ZodOptional<z.ZodNumber>;
-    durationMs: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type MediaAttachment = z.infer<typeof MediaAttachmentSchema>;
+export type MediaAttachmentKind = 'image' | 'audio' | 'video' | 'file';
+export interface MediaAttachment {
+    kind: MediaAttachmentKind;
+    url: string;
+    mimeType?: string;
+    fileName?: string;
+    sizeBytes?: number;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+}
 export declare function inferMediaAttachmentKind(mimeType: string): MediaAttachmentKind;
 export declare function getStoredFileExtension(input: {
     mimeType?: string | null;

package/dist/media.js

@@ -1,15 +1,3 @@
-import { z } from 'zod';
-export const MediaAttachmentKindSchema = z.enum(['image', 'audio', 'video', 'file']);
-export const MediaAttachmentSchema = z.object({
-    kind: MediaAttachmentKindSchema,
-    url: z.string(),
-    mimeType: z.string().optional(),
-    fileName: z.string().optional(),
-    sizeBytes: z.number().optional(),
-    width: z.number().optional(),
-    height: z.number().optional(),
-    durationMs: z.number().optional(),
-});
 export function inferMediaAttachmentKind(mimeType) {
     if (mimeType.startsWith('image/'))
         return 'image';

package/dist/message.d.ts

@@ -1,134 +1,51 @@
-import { z } from 'zod';
-export declare const SerializedSenderTypeSchema: z.ZodEnum<{
-    human: "human";
-    ai_agent: "ai_agent";
-}>;
-export type SerializedSenderType = z.infer<typeof SerializedSenderTypeSchema>;
-export declare const SerializedAgentClientTypeSchema: z.ZodEnum<{
-    "claude-code": "claude-code";
-    openclaw: "openclaw";
-    codex: "codex";
-    hermes: "hermes";
-    generic: "generic";
-}>;
-export type SerializedAgentClientType = z.infer<typeof SerializedAgentClientTypeSchema>;
-export declare const SerializedContentTypeSchema: z.ZodEnum<{
-    file: "file";
-    image: "image";
-    audio: "audio";
-    video: "video";
-    text: "text";
-    contact_card: "contact_card";
-}>;
-export type SerializedContentType = z.infer<typeof SerializedContentTypeSchema>;
-export declare const ForwardedFromSchema: z.ZodObject<{
-    sourceConversationId: z.ZodString;
-    messageId: z.ZodString;
-}, z.core.$strip>;
-export type ForwardedFrom = z.infer<typeof ForwardedFromSchema>;
-export declare const SerializedReactionsSchema: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
-export type SerializedReactions = z.infer<typeof SerializedReactionsSchema>;
-export declare const SerializedContactCardSchema: z.ZodObject<{
-    userId: z.ZodString;
-    canonContactId: z.ZodOptional<z.ZodString>;
-    displayName: z.ZodString;
-    avatarUrl: z.ZodNullable<z.ZodString>;
-    userType: z.ZodEnum<{
-        human: "human";
-        ai_agent: "ai_agent";
-    }>;
-    clientType: z.ZodOptional<z.ZodEnum<{
-        "claude-code": "claude-code";
-        openclaw: "openclaw";
-        codex: "codex";
-        hermes: "hermes";
-        generic: "generic";
-    }>>;
-    about: z.ZodOptional<z.ZodString>;
-    isActive: z.ZodOptional<z.ZodBoolean>;
-    ownerId: z.ZodOptional<z.ZodString>;
-    ownerName: z.ZodOptional<z.ZodString>;
-    lifecycleState: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SerializedContactCard = z.infer<typeof SerializedContactCardSchema>;
-export declare const SerializedMessageSchema: z.ZodObject<{
-    id: z.ZodString;
-    senderId: z.ZodString;
-    senderName: z.ZodOptional<z.ZodString>;
-    senderType: z.ZodEnum<{
-        human: "human";
-        ai_agent: "ai_agent";
-    }>;
-    isOwner: z.ZodBoolean;
-    contentType: z.ZodEnum<{
-        file: "file";
-        image: "image";
-        audio: "audio";
-        video: "video";
-        text: "text";
-        contact_card: "contact_card";
-    }>;
-    text: z.ZodNullable<z.ZodString>;
-    attachments: z.ZodArray<z.ZodObject<{
-        kind: z.ZodEnum<{
-            file: "file";
-            image: "image";
-            audio: "audio";
-            video: "video";
-        }>;
-        url: z.ZodString;
-        mimeType: z.ZodOptional<z.ZodString>;
-        fileName: z.ZodOptional<z.ZodString>;
-        sizeBytes: z.ZodOptional<z.ZodNumber>;
-        width: z.ZodOptional<z.ZodNumber>;
-        height: z.ZodOptional<z.ZodNumber>;
-        durationMs: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    mentions: z.ZodArray<z.ZodString>;
-    replyTo: z.ZodNullable<z.ZodString>;
-    replyToPosition: z.ZodNullable<z.ZodNumber>;
-    forwarded: z.ZodOptional<z.ZodBoolean>;
-    forwardedFrom: z.ZodOptional<z.ZodObject<{
-        sourceConversationId: z.ZodString;
-        messageId: z.ZodString;
-    }, z.core.$strip>>;
-    status: z.ZodEnum<{
-        sent: "sent";
-        read: "read";
-    }>;
-    createdAt: z.ZodString;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    contactCard: z.ZodOptional<z.ZodObject<{
-        userId: z.ZodString;
-        canonContactId: z.ZodOptional<z.ZodString>;
-        displayName: z.ZodString;
-        avatarUrl: z.ZodNullable<z.ZodString>;
-        userType: z.ZodEnum<{
-            human: "human";
-            ai_agent: "ai_agent";
-        }>;
-        clientType: z.ZodOptional<z.ZodEnum<{
-            "claude-code": "claude-code";
-            openclaw: "openclaw";
-            codex: "codex";
-            hermes: "hermes";
-            generic: "generic";
-        }>>;
-        about: z.ZodOptional<z.ZodString>;
-        isActive: z.ZodOptional<z.ZodBoolean>;
-        ownerId: z.ZodOptional<z.ZodString>;
-        ownerName: z.ZodOptional<z.ZodString>;
-        lifecycleState: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    runtimeCard: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    reactions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>;
-export type SerializedMessage = z.infer<typeof SerializedMessageSchema>;
-export declare const SerializeMessageInputSchema: z.ZodObject<{
-    id: z.ZodString;
-    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    senderName: z.ZodOptional<z.ZodString>;
-    isOwner: z.ZodBoolean;
-}, z.core.$strip>;
-export type SerializeMessageInput = z.infer<typeof SerializeMessageInputSchema>;
+import { MediaAttachment } from './media.js';
+export type SerializedSenderType = 'human' | 'ai_agent';
+export type SerializedAgentClientType = 'claude-code' | 'openclaw' | 'codex' | 'hermes' | 'generic';
+export type SerializedContentType = 'text' | 'image' | 'audio' | 'video' | 'file' | 'contact_card';
+export interface ForwardedFrom {
+    sourceConversationId: string;
+    messageId: string;
+}
+export type SerializedReactions = Record<string, string[]>;
+export interface SerializedContactCard {
+    userId: string;
+    canonContactId?: string;
+    displayName: string;
+    avatarUrl: string | null;
+    userType: SerializedSenderType;
+    clientType?: SerializedAgentClientType;
+    about?: string;
+    isActive?: boolean;
+    ownerId?: string;
+    ownerName?: string;
+    lifecycleState?: string;
+}
+export interface SerializedMessage {
+    id: string;
+    senderId: string;
+    senderName?: string;
+    senderType: SerializedSenderType;
+    isOwner: boolean;
+    contentType: SerializedContentType;
+    text: string | null;
+    attachments: MediaAttachment[];
+    mentions: string[];
+    replyTo: string | null;
+    replyToPosition: number | null;
+    forwarded?: boolean;
+    forwardedFrom?: ForwardedFrom;
+    status: 'sent' | 'read';
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+    contactCard?: SerializedContactCard;
+    /** Durable canon.card.v1 runtime card content, passed through opaquely. */
+    runtimeCard?: Record<string, unknown>;
+    reactions?: SerializedReactions;
+}
+export interface SerializeMessageInput {
+    id: string;
+    data: Record<string, unknown>;
+    senderName?: string;
+    isOwner: boolean;
+}
 export declare function serializeStoredMessage(input: SerializeMessageInput): SerializedMessage;

package/dist/message.js

@@ -1,68 +1,5 @@
-import { z } from 'zod';
-import { MediaAttachmentSchema, normalizeStoredAttachments } from './media.js';
+import { normalizeStoredAttachments } from './media.js';
 import { decodeStoredRuntimeCard } from './runtimeCardStorage.js';
-export const SerializedSenderTypeSchema = z.enum(['human', 'ai_agent']);
-export const SerializedAgentClientTypeSchema = z.enum([
-    'claude-code',
-    'openclaw',
-    'codex',
-    'hermes',
-    'generic',
-]);
-export const SerializedContentTypeSchema = z.enum([
-    'text',
-    'image',
-    'audio',
-    'video',
-    'file',
-    'contact_card',
-]);
-export const ForwardedFromSchema = z.object({
-    sourceConversationId: z.string(),
-    messageId: z.string(),
-});
-export const SerializedReactionsSchema = z.record(z.string(), z.array(z.string()));
-export const SerializedContactCardSchema = z.object({
-    userId: z.string(),
-    canonContactId: z.string().optional(),
-    displayName: z.string(),
-    avatarUrl: z.string().nullable(),
-    userType: SerializedSenderTypeSchema,
-    clientType: SerializedAgentClientTypeSchema.optional(),
-    about: z.string().optional(),
-    isActive: z.boolean().optional(),
-    ownerId: z.string().optional(),
-    ownerName: z.string().optional(),
-    lifecycleState: z.string().optional(),
-});
-export const SerializedMessageSchema = z.object({
-    id: z.string(),
-    senderId: z.string(),
-    senderName: z.string().optional(),
-    senderType: SerializedSenderTypeSchema,
-    isOwner: z.boolean(),
-    contentType: SerializedContentTypeSchema,
-    text: z.string().nullable(),
-    attachments: z.array(MediaAttachmentSchema),
-    mentions: z.array(z.string()),
-    replyTo: z.string().nullable(),
-    replyToPosition: z.number().nullable(),
-    forwarded: z.boolean().optional(),
-    forwardedFrom: ForwardedFromSchema.optional(),
-    status: z.enum(['sent', 'read']),
-    createdAt: z.string(),
-    metadata: z.record(z.string(), z.unknown()).optional(),
-    contactCard: SerializedContactCardSchema.optional(),
-    /** Durable canon.card.v1 runtime card content, passed through opaquely. */
-    runtimeCard: z.record(z.string(), z.unknown()).optional(),
-    reactions: SerializedReactionsSchema.optional(),
-});
-export const SerializeMessageInputSchema = z.object({
-    id: z.string(),
-    data: z.record(z.string(), z.unknown()),
-    senderName: z.string().optional(),
-    isOwner: z.boolean(),
-});
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/runtimeCardFields.d.ts

@@ -1,17 +1,4 @@
-import { z } from 'zod';
-export declare const RuntimeCardFieldTypeSchema: z.ZodEnum<{
-    number: "number";
-    boolean: "boolean";
-    date: "date";
-    text: "text";
-    textarea: "textarea";
-    select: "select";
-    multiSelect: "multiSelect";
-    currency: "currency";
-    searchSelect: "searchSelect";
-    lineItems: "lineItems";
-}>;
-export type RuntimeCardFieldType = z.infer<typeof RuntimeCardFieldTypeSchema>;
+export type RuntimeCardFieldType = 'text' | 'textarea' | 'select' | 'multiSelect' | 'boolean' | 'date' | 'number' | 'currency' | 'searchSelect' | 'lineItems';
 /**
  * Caps shared across runtime-card normalizers, response validation, and
  * authoring tools. Keep these backend-safe so Functions can import them.
@@ -22,104 +9,44 @@ export declare const RUNTIME_CARD_LIMITS: {
     readonly lineItemColumns: 8;
     readonly searchSelectChoices: 100;
 };
-export declare const RuntimeCardFieldChoiceSchema: z.ZodObject<{
-    label: z.ZodString;
-    value: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    preview: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type RuntimeCardFieldChoice = z.infer<typeof RuntimeCardFieldChoiceSchema>;
-export declare const RuntimeCardLineItemColumnTypeSchema: z.ZodEnum<{
-    number: "number";
-    date: "date";
-    text: "text";
-    select: "select";
-    currency: "currency";
-}>;
-export type RuntimeCardLineItemColumnType = z.infer<typeof RuntimeCardLineItemColumnTypeSchema>;
-export declare const RuntimeCardLineItemColumnSchema: z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    type: z.ZodEnum<{
-        number: "number";
-        date: "date";
-        text: "text";
-        select: "select";
-        currency: "currency";
-    }>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        value: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        preview: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    min: z.ZodOptional<z.ZodNumber>;
-    max: z.ZodOptional<z.ZodNumber>;
-    step: z.ZodOptional<z.ZodNumber>;
-    precision: z.ZodOptional<z.ZodNumber>;
-    currencyCode: z.ZodOptional<z.ZodString>;
-    allowOther: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export type RuntimeCardLineItemColumn = z.infer<typeof RuntimeCardLineItemColumnSchema>;
-export declare const RuntimeCardFieldSchema: z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    type: z.ZodEnum<{
-        number: "number";
-        boolean: "boolean";
-        date: "date";
-        text: "text";
-        textarea: "textarea";
-        select: "select";
-        multiSelect: "multiSelect";
-        currency: "currency";
-        searchSelect: "searchSelect";
-        lineItems: "lineItems";
-    }>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    placeholder: z.ZodOptional<z.ZodString>;
-    choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        value: z.ZodOptional<z.ZodString>;
-        description: z.ZodOptional<z.ZodString>;
-        preview: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    allowOther: z.ZodOptional<z.ZodBoolean>;
-    sensitive: z.ZodOptional<z.ZodBoolean>;
-    min: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-    max: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-    step: z.ZodOptional<z.ZodNumber>;
-    precision: z.ZodOptional<z.ZodNumber>;
-    currencyCode: z.ZodOptional<z.ZodString>;
-    columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        label: z.ZodString;
-        type: z.ZodEnum<{
-            number: "number";
-            date: "date";
-            text: "text";
-            select: "select";
-            currency: "currency";
-        }>;
-        required: z.ZodOptional<z.ZodBoolean>;
-        choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            value: z.ZodOptional<z.ZodString>;
-            description: z.ZodOptional<z.ZodString>;
-            preview: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
-        min: z.ZodOptional<z.ZodNumber>;
-        max: z.ZodOptional<z.ZodNumber>;
-        step: z.ZodOptional<z.ZodNumber>;
-        precision: z.ZodOptional<z.ZodNumber>;
-        currencyCode: z.ZodOptional<z.ZodString>;
-        allowOther: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
-    minRows: z.ZodOptional<z.ZodNumber>;
-    maxRows: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-export type RuntimeCardField = z.infer<typeof RuntimeCardFieldSchema>;
+export interface RuntimeCardFieldChoice {
+    label: string;
+    value?: string;
+    description?: string;
+    preview?: string;
+}
+export type RuntimeCardLineItemColumnType = 'text' | 'number' | 'currency' | 'date' | 'select';
+export interface RuntimeCardLineItemColumn {
+    id: string;
+    label: string;
+    type: RuntimeCardLineItemColumnType;
+    required?: boolean;
+    choices?: RuntimeCardFieldChoice[];
+    min?: number;
+    max?: number;
+    step?: number;
+    precision?: number;
+    currencyCode?: string;
+    allowOther?: boolean;
+}
+export interface RuntimeCardField {
+    id: string;
+    label: string;
+    type: RuntimeCardFieldType;
+    required?: boolean;
+    placeholder?: string;
+    choices?: RuntimeCardFieldChoice[];
+    allowOther?: boolean;
+    sensitive?: boolean;
+    min?: number | string;
+    max?: number | string;
+    step?: number;
+    precision?: number;
+    currencyCode?: string;
+    columns?: RuntimeCardLineItemColumn[];
+    minRows?: number;
+    maxRows?: number;
+}
 export declare function validateRuntimeCardFieldValues(input: {
     actionId: string | undefined;
     actionFields: ReadonlyArray<RuntimeCardField> | undefined;

package/dist/runtimeCardFields.js

@@ -1,16 +1,3 @@
-import { z } from 'zod';
-export const RuntimeCardFieldTypeSchema = z.enum([
-    'text',
-    'textarea',
-    'select',
-    'multiSelect',
-    'boolean',
-    'date',
-    'number',
-    'currency',
-    'searchSelect',
-    'lineItems',
-]);
 /**
  * Caps shared across runtime-card normalizers, response validation, and
  * authoring tools. Keep these backend-safe so Functions can import them.
@@ -21,50 +8,6 @@ export const RUNTIME_CARD_LIMITS = {
     lineItemColumns: 8,
     searchSelectChoices: 100,
 };
-export const RuntimeCardFieldChoiceSchema = z.object({
-    label: z.string(),
-    value: z.string().optional(),
-    description: z.string().optional(),
-    preview: z.string().optional(),
-});
-export const RuntimeCardLineItemColumnTypeSchema = z.enum([
-    'text',
-    'number',
-    'currency',
-    'date',
-    'select',
-]);
-export const RuntimeCardLineItemColumnSchema = z.object({
-    id: z.string(),
-    label: z.string(),
-    type: RuntimeCardLineItemColumnTypeSchema,
-    required: z.boolean().optional(),
-    choices: z.array(RuntimeCardFieldChoiceSchema).optional(),
-    min: z.number().optional(),
-    max: z.number().optional(),
-    step: z.number().optional(),
-    precision: z.number().optional(),
-    currencyCode: z.string().optional(),
-    allowOther: z.boolean().optional(),
-});
-export const RuntimeCardFieldSchema = z.object({
-    id: z.string(),
-    label: z.string(),
-    type: RuntimeCardFieldTypeSchema,
-    required: z.boolean().optional(),
-    placeholder: z.string().optional(),
-    choices: z.array(RuntimeCardFieldChoiceSchema).optional(),
-    allowOther: z.boolean().optional(),
-    sensitive: z.boolean().optional(),
-    min: z.union([z.number(), z.string()]).optional(),
-    max: z.union([z.number(), z.string()]).optional(),
-    step: z.number().optional(),
-    precision: z.number().optional(),
-    currencyCode: z.string().optional(),
-    columns: z.array(RuntimeCardLineItemColumnSchema).optional(),
-    minRows: z.number().optional(),
-    maxRows: z.number().optional(),
-});
 const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);