@canonmsg/core 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -29,5 +29,6 @@ export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, build
 export type { ConfiguredWorkspaceOption, ExecutionEnvironmentMode, PreparedExecutionEnvironment, SessionWorkspaceConfig, } from './execution-environment.js';
 export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
 export type { AgentSessionSnapshotPatch, RuntimeInfoPayloadData, SessionStatePayload, TurnStatePayload, } from './rtdb-rest.js';
+export { formatCanonMessageAsText } from './message-format.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 export { resolveCanonBaseUrl } from './base-url.js';

package/dist/index.js

@@ -27,6 +27,8 @@ export { resolveCanonAgent, resolveCanonProfile, getActiveProfile } from './agen
 export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, buildConversationWorktreeSpec, buildPublicWorkspaceOptions, buildWorkspaceOptionId, EXECUTION_ENVIRONMENT_MODES, isEnabledFlag, isExecutionEnvironmentMode, normalizeOptionalString, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, ExecutionEnvironmentError, prepareConversationEnvironment, releaseConversationEnvironment, } from './execution-environment.js';
 // RTDB REST helpers (token exchange, session state, generic read/write)
 export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
+// Message formatting (LLM-facing text projection)
+export { formatCanonMessageAsText } from './message-format.js';
 // Constants
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 // Base URL resolver

package/dist/message-format.d.ts

@@ -0,0 +1,13 @@
+import type { CanonMessage } from './types.js';
+/**
+ * Project a CanonMessage to a single text representation suitable as a
+ * baseline for plugins that feed messages to an LLM as plain text.
+ *
+ * Plugins that compose richer prompts (placeholders, capability hints,
+ * native vision input) layer on top of this — the goal here is only to
+ * guarantee that no contentType is ever silently dropped to an empty
+ * string. Adding a new contentType to CanonMessage and forgetting to
+ * handle it here surfaces in this file's tests, not as a silent
+ * regression in every consumer plugin.
+ */
+export declare function formatCanonMessageAsText(message: Pick<CanonMessage, 'contentType' | 'text' | 'attachments' | 'contactCard'>): string;

package/dist/message-format.js

@@ -0,0 +1,47 @@
+/**
+ * Project a CanonMessage to a single text representation suitable as a
+ * baseline for plugins that feed messages to an LLM as plain text.
+ *
+ * Plugins that compose richer prompts (placeholders, capability hints,
+ * native vision input) layer on top of this — the goal here is only to
+ * guarantee that no contentType is ever silently dropped to an empty
+ * string. Adding a new contentType to CanonMessage and forgetting to
+ * handle it here surfaces in this file's tests, not as a silent
+ * regression in every consumer plugin.
+ */
+export function formatCanonMessageAsText(message) {
+    if (message.contentType === 'contact_card' && message.contactCard) {
+        return formatContactCard(message.contactCard);
+    }
+    const attachment = pickPrimaryAttachment(message.attachments);
+    const trimmedText = typeof message.text === 'string' ? message.text.trim() : '';
+    if (attachment?.kind === 'image') {
+        return trimmedText ? `[image] ${trimmedText}` : '[image]';
+    }
+    if (attachment?.kind === 'audio') {
+        const seconds = typeof attachment.durationMs === 'number'
+            ? ` ${Math.round(attachment.durationMs / 1000)}s`
+            : '';
+        return trimmedText ? `[audio${seconds}] ${trimmedText}` : `[audio${seconds}]`;
+    }
+    if (attachment?.kind === 'file') {
+        const label = attachment.fileName?.trim() || 'file';
+        return trimmedText ? `[${label}] ${trimmedText}` : `[${label}]`;
+    }
+    return trimmedText || '[message]';
+}
+function pickPrimaryAttachment(attachments) {
+    const first = attachments?.[0];
+    return first?.url ? first : null;
+}
+function formatContactCard(card) {
+    const displayName = card.displayName?.trim() || 'Unknown';
+    const parts = [card.userType, `userId: ${card.userId}`];
+    if (card.ownerName)
+        parts.push(`owner: ${card.ownerName}`);
+    if (card.accessLevel)
+        parts.push(`access: ${card.accessLevel}`);
+    if (card.about)
+        parts.push(`about: ${card.about}`);
+    return `[Contact card] "${displayName}" — ${parts.join(' · ')}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/core",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Canon core — shared types, REST client, SSE stream, and registration for Canon messaging",
   "type": "module",
   "main": "dist/index.js",