@canonmsg/backend-contracts 6.1.0 → 6.3.0

package/dist/cjs/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./diffRedaction.js"), exports);
 __exportStar(require("./environment.js"), exports);
 __exportStar(require("./media.js"), exports);
 __exportStar(require("./message.js"), exports);
+__exportStar(require("./messageText.js"), exports);
 __exportStar(require("./runtimeCardFields.js"), exports);
 __exportStar(require("./runtimeCardStorage.js"), exports);
 __exportStar(require("./turnProtocol.js"), exports);

package/dist/cjs/message.js

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_CLIENT_TYPES = void 0;
 exports.serializeStoredMessage = serializeStoredMessage;
 const media_js_1 = require("./media.js");
 const runtimeCardStorage_js_1 = require("./runtimeCardStorage.js");
+/** Canonical agent client identifiers shared by Canon services and clients. */
+exports.AGENT_CLIENT_TYPES = [
+    'claude-code',
+    'openclaw',
+    'codex',
+    'hermes',
+    'deepseek-harness',
+    'generic',
+];
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -46,14 +56,9 @@ function requireSenderType(value) {
     throw new Error('Message is missing canonical senderType');
 }
 function normalizeAgentClientType(value) {
-    if (value === 'claude-code'
-        || value === 'openclaw'
-        || value === 'codex'
-        || value === 'hermes'
-        || value === 'generic') {
-        return value;
-    }
-    return undefined;
+    return exports.AGENT_CLIENT_TYPES.includes(value)
+        ? value
+        : undefined;
 }
 function normalizeContentType(value) {
     if (value === 'text'

package/dist/cjs/messageText.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HUMAN_MESSAGE_TEXT_MAX_BYTES = void 0;
+exports.messageTextUtf8ByteLength = messageTextUtf8ByteLength;
+exports.isHumanMessageTextWithinLimit = isHumanMessageTextWithinLimit;
+/** Maximum UTF-8 payload size for a human-authored message. */
+exports.HUMAN_MESSAGE_TEXT_MAX_BYTES = 32 * 1024;
+const UTF8_ENCODER = new TextEncoder();
+/** Returns the encoded UTF-8 size used by the message API. */
+function messageTextUtf8ByteLength(value) {
+    return UTF8_ENCODER.encode(value).byteLength;
+}
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+function isHumanMessageTextWithinLimit(value) {
+    return messageTextUtf8ByteLength(value) <= exports.HUMAN_MESSAGE_TEXT_MAX_BYTES;
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './diffRedaction.js';
 export * from './environment.js';
 export * from './media.js';
 export * from './message.js';
+export * from './messageText.js';
 export * from './runtimeCardFields.js';
 export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './diffRedaction.js';
 export * from './environment.js';
 export * from './media.js';
 export * from './message.js';
+export * from './messageText.js';
 export * from './runtimeCardFields.js';
 export * from './runtimeCardStorage.js';
 export * from './turnProtocol.js';

package/dist/message.d.ts

@@ -1,6 +1,8 @@
 import { MediaAttachment } from './media.js';
 export type SerializedSenderType = 'human' | 'ai_agent';
-export type SerializedAgentClientType = 'claude-code' | 'openclaw' | 'codex' | 'hermes' | 'generic';
+/** Canonical agent client identifiers shared by Canon services and clients. */
+export declare const AGENT_CLIENT_TYPES: readonly ["claude-code", "openclaw", "codex", "hermes", "deepseek-harness", "generic"];
+export type SerializedAgentClientType = typeof AGENT_CLIENT_TYPES[number];
 export type SerializedContentType = 'text' | 'image' | 'audio' | 'video' | 'file' | 'contact_card' | 'interaction';
 export interface ForwardedFrom {
     sourceConversationId: string;

package/dist/message.js

@@ -1,5 +1,14 @@
 import { normalizeStoredAttachments } from './media.js';
 import { decodeStoredRuntimeCard } from './runtimeCardStorage.js';
+/** Canonical agent client identifiers shared by Canon services and clients. */
+export const AGENT_CLIENT_TYPES = [
+    'claude-code',
+    'openclaw',
+    'codex',
+    'hermes',
+    'deepseek-harness',
+    'generic',
+];
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -43,14 +52,9 @@ function requireSenderType(value) {
     throw new Error('Message is missing canonical senderType');
 }
 function normalizeAgentClientType(value) {
-    if (value === 'claude-code'
-        || value === 'openclaw'
-        || value === 'codex'
-        || value === 'hermes'
-        || value === 'generic') {
-        return value;
-    }
-    return undefined;
+    return AGENT_CLIENT_TYPES.includes(value)
+        ? value
+        : undefined;
 }
 function normalizeContentType(value) {
     if (value === 'text'

package/dist/messageText.d.ts

@@ -0,0 +1,6 @@
+/** Maximum UTF-8 payload size for a human-authored message. */
+export declare const HUMAN_MESSAGE_TEXT_MAX_BYTES: number;
+/** Returns the encoded UTF-8 size used by the message API. */
+export declare function messageTextUtf8ByteLength(value: string): number;
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+export declare function isHumanMessageTextWithinLimit(value: string): boolean;

package/dist/messageText.js

@@ -0,0 +1,11 @@
+/** Maximum UTF-8 payload size for a human-authored message. */
+export const HUMAN_MESSAGE_TEXT_MAX_BYTES = 32 * 1024;
+const UTF8_ENCODER = new TextEncoder();
+/** Returns the encoded UTF-8 size used by the message API. */
+export function messageTextUtf8ByteLength(value) {
+    return UTF8_ENCODER.encode(value).byteLength;
+}
+/** Whether human-authored message text fits the API's UTF-8 byte budget. */
+export function isHumanMessageTextWithinLimit(value) {
+    return messageTextUtf8ByteLength(value) <= HUMAN_MESSAGE_TEXT_MAX_BYTES;
+}

package/package.json

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