@canonmsg/core 0.18.0 → 0.18.1

package/dist/host-runtime.d.ts

@@ -23,13 +23,31 @@ export interface HostInboundParticipantContext {
 }
 type HostInboundMessage = {
     id?: string | null;
+    senderId?: string | null;
+    senderName?: string | null;
     text?: string | null;
     contentType?: CanonMessage['contentType'] | null;
     attachments?: CanonMessage['attachments'];
     senderType?: CanonMessage['senderType'];
     mentions?: string[] | null;
     contactCard?: CanonMessage['contactCard'];
+    replyTo?: string | null;
+    replyToPosition?: number | null;
+    deleted?: boolean | null;
 };
+export interface CanonReplyContext {
+    messageId: string;
+    senderId?: string | null;
+    senderName?: string | null;
+    senderType?: CanonMessage['senderType'] | null;
+    text?: string | null;
+    contentType?: CanonMessage['contentType'] | null;
+    attachments?: CanonMessage['attachments'];
+    contactCard?: CanonMessage['contactCard'];
+    body: string;
+    replyToPosition?: number | null;
+    found: boolean;
+}
 export declare function buildCanonHostPrompt(input: {
     hostLabel: string;
     content: string;
@@ -37,9 +55,11 @@ export declare function buildCanonHostPrompt(input: {
     participantContext: HostInboundParticipantContext;
     behavior?: ResolvedAgentBehaviorPolicy | null;
     selfContexts?: MessageCreatedPayload['selfContexts'];
+    replyContext?: CanonReplyContext | null;
     buildInboundContextLines: (context: HostInboundParticipantContext) => string[];
     sessionContextLines?: string[];
 }): string;
+export declare function buildCanonReplyContextLines(replyContext: CanonReplyContext | null): string[];
 /**
  * Render the **text portion** of an inbound Canon message. Images are
  * referenced by short placeholders — their actual bytes are delivered to the
@@ -60,6 +80,10 @@ export declare function renderCanonHostInboundContent(message: HostInboundMessag
     durationMs?: number;
     index: number;
 }>): string;
+export declare function resolveCanonReplyContext(input: {
+    message: HostInboundMessage;
+    messages?: ReadonlyArray<HostInboundMessage> | null;
+}): CanonReplyContext | null;
 export declare function buildHydratedInboundContext(input: {
     agentId: string;
     conversation: CanonConversation | null;
@@ -78,6 +102,7 @@ export declare function buildHydratedInboundContext(input: {
     behavior?: ResolvedAgentBehaviorPolicy | null;
     activeSelfContextId: string | null;
     selfContexts: NonNullable<MessageCreatedPayload['selfContexts']>;
+    replyContext: CanonReplyContext | null;
     hydratedFromPage: boolean;
 };
 export declare function publishHostAgentRuntime(agentId: string, clientType: AgentClientType, runtime: AgentRuntime): Promise<void>;

package/dist/host-runtime.js

@@ -29,11 +29,32 @@ export function buildCanonHostPrompt(input) {
             ? ['Canon session state:', ...input.sessionContextLines]
             : []),
         `Conversation ID: ${input.conversationId}`,
+        ...buildCanonReplyContextLines(input.replyContext ?? null),
         '',
         'New Canon message:',
         input.content,
     ].join('\n');
 }
+export function buildCanonReplyContextLines(replyContext) {
+    if (!replyContext)
+        return [];
+    const sender = replyContext.senderName || replyContext.senderId || 'unknown sender';
+    const senderType = replyContext.senderType ? `, ${replyContext.senderType}` : '';
+    const position = replyContext.replyToPosition != null
+        ? ` at ${formatReplyPosition(replyContext.replyToPosition)}`
+        : '';
+    const header = replyContext.found
+        ? `This message is replying to ${sender}${senderType} (message ${replyContext.messageId}${position}).`
+        : `This message is replying to message ${replyContext.messageId}${position}, but that message was not present in fetched history.`;
+    return [
+        '',
+        'Reply context:',
+        header,
+        ...(replyContext.found
+            ? ['Replied message:', replyContext.body]
+            : []),
+    ];
+}
 /**
  * Render the **text portion** of an inbound Canon message. Images are
  * referenced by short placeholders — their actual bytes are delivered to the
@@ -62,6 +83,35 @@ export function renderCanonHostInboundContent(message, materialized) {
     const rendered = [...placeholders, body].filter(Boolean).join('\n');
     return rendered || '[Empty message]';
 }
+export function resolveCanonReplyContext(input) {
+    const replyTo = normalizeOptionalString(input.message.replyTo);
+    if (!replyTo)
+        return null;
+    const referenced = input.messages
+        ?.find((message) => message.id === replyTo && message.deleted !== true)
+        ?? null;
+    if (!referenced) {
+        return {
+            messageId: replyTo,
+            body: '',
+            replyToPosition: input.message.replyToPosition ?? null,
+            found: false,
+        };
+    }
+    return {
+        messageId: replyTo,
+        senderId: referenced.senderId ?? null,
+        senderName: referenced.senderName ?? null,
+        senderType: referenced.senderType ?? null,
+        text: referenced.text ?? null,
+        contentType: referenced.contentType ?? null,
+        attachments: referenced.attachments ?? [],
+        ...(referenced.contactCard ? { contactCard: referenced.contactCard } : {}),
+        body: renderCanonHostInboundContent(referenced),
+        replyToPosition: input.message.replyToPosition ?? null,
+        found: true,
+    };
+}
 function describeContactCard(card) {
     const parts = [`${card.userType} · userId: ${card.userId}`];
     if (card.ownerName)
@@ -88,7 +138,8 @@ function describeContactCard(card) {
 }
 function describeAttachment(attachment, materialized) {
     if (attachment.kind === 'image') {
-        return '[Image attached]';
+        const ref = materialized?.path ? ` ${materialized.path}` : '';
+        return `[Image attached${ref}]`;
     }
     if (attachment.kind === 'audio') {
         const durationMs = materialized?.durationMs ?? attachment.durationMs;
@@ -101,6 +152,16 @@ function describeAttachment(attachment, materialized) {
     const ref = materialized?.path ? ` ${materialized.path}` : '';
     return `[File: ${label}${ref}]`;
 }
+function formatReplyPosition(positionMs) {
+    if (!Number.isFinite(positionMs) || positionMs < 0)
+        return `${positionMs}ms`;
+    const totalSeconds = Math.floor(positionMs / 1000);
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return minutes > 0
+        ? `${minutes}:${seconds.toString().padStart(2, '0')}`
+        : `${seconds}s`;
+}
 export function buildHydratedInboundContext(input) {
     const history = buildParticipationHistorySnapshot(input.page?.messages ?? [], input.agentId);
     const activeSelfContextId = resolveMessageActiveSelfContextId({
@@ -142,6 +203,10 @@ export function buildHydratedInboundContext(input) {
         behavior: input.page?.behavior ?? input.conversation?.behavior,
         activeSelfContextId: activeSelfContexts.length > 0 ? activeSelfContextId : null,
         selfContexts: activeSelfContexts,
+        replyContext: resolveCanonReplyContext({
+            message: input.message,
+            messages: input.page?.messages ?? [],
+        }),
         hydratedFromPage: input.page != null,
     };
 }

package/dist/index.d.ts

@@ -32,8 +32,8 @@ export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, build
 export type { ConfiguredWorkspaceOption, ExecutionEnvironmentMode, PreparedExecutionEnvironment, SessionWorkspaceConfig, } from './execution-environment.js';
 export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, readRuntimeActivity, writeRuntimeActivity, removeRuntimeActivityItem, clearRuntimeActivity, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
 export type { AgentSessionSnapshotPatch, RTDBClientHandle, RuntimeActivityPayloadData, RuntimeInfoPayloadData, SessionStatePayload, TurnStatePayload, } from './rtdb-rest.js';
-export { buildCanonHostPrompt, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, publishHostSessionSnapshots, readHostSessionConfig, renderCanonHostInboundContent, resolveHostWorkspaceCwd, } from './host-runtime.js';
-export type { HostInboundParticipantContext, } from './host-runtime.js';
+export { buildCanonHostPrompt, buildCanonReplyContextLines, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, publishHostSessionSnapshots, readHostSessionConfig, renderCanonHostInboundContent, resolveCanonReplyContext, resolveHostWorkspaceCwd, } from './host-runtime.js';
+export type { CanonReplyContext, HostInboundParticipantContext, } from './host-runtime.js';
 export { buildCanonGroupContext, buildCanonKnownRecentParticipants, buildCompactGroupContextLines, diffCanonMemberIds, } from './group-context.js';
 export { createRuntimeStatePublisher, } from './runtime-state-publisher.js';
 export type { RuntimeStatePublisher, RuntimeStatePublisherOptions, RuntimeStreamingPayload, ClearRuntimeActivityOptions, } from './runtime-state-publisher.js';

package/dist/index.js

@@ -31,7 +31,7 @@ export { buildConfiguredWorkspaceOptions, buildConversationEnvironmentKey, build
 // RTDB REST helpers (token exchange, session state, generic read/write)
 export { initRTDBAuth, rtdbWrite, rtdbRead, patchAgentSessionSnapshot, patchRuntimeInfo, readRuntimeActivity, writeRuntimeActivity, removeRuntimeActivityItem, clearRuntimeActivity, writeRuntimeInfo, clearRuntimeInfo, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from './rtdb-rest.js';
 // Runtime host plumbing
-export { buildCanonHostPrompt, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, publishHostSessionSnapshots, readHostSessionConfig, renderCanonHostInboundContent, resolveHostWorkspaceCwd, } from './host-runtime.js';
+export { buildCanonHostPrompt, buildCanonReplyContextLines, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, publishHostSessionSnapshots, readHostSessionConfig, renderCanonHostInboundContent, resolveCanonReplyContext, resolveHostWorkspaceCwd, } from './host-runtime.js';
 export { buildCanonGroupContext, buildCanonKnownRecentParticipants, buildCompactGroupContextLines, diffCanonMemberIds, } from './group-context.js';
 export { createRuntimeStatePublisher, } from './runtime-state-publisher.js';
 // Message formatting (LLM-facing text projection)

package/dist/message-format.js

@@ -15,26 +15,14 @@ export function formatCanonMessageAsText(message) {
         const cardText = formatContactCard(message.contactCard);
         return trimmedText ? `${cardText}\n${trimmedText}` : cardText;
     }
-    const attachment = pickPrimaryAttachment(message.attachments);
-    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}]`;
+    const attachmentLabels = (message.attachments ?? [])
+        .filter((attachment) => Boolean(attachment.url))
+        .map(formatAttachment);
+    if (attachmentLabels.length > 0) {
+        return [...attachmentLabels, trimmedText].filter(Boolean).join('\n');
     }
     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}`];
@@ -44,3 +32,16 @@ function formatContactCard(card) {
         parts.push(`about: ${card.about}`);
     return `[Contact card] "${displayName}" — ${parts.join(' · ')}`;
 }
+function formatAttachment(attachment) {
+    if (attachment.kind === 'image') {
+        return '[image]';
+    }
+    if (attachment.kind === 'audio') {
+        const seconds = typeof attachment.durationMs === 'number'
+            ? ` ${Math.round(attachment.durationMs / 1000)}s`
+            : '';
+        return `[audio${seconds}]`;
+    }
+    const label = attachment.fileName?.trim() || 'file';
+    return `[${label}]`;
+}

package/dist/runtime-descriptor.js

@@ -8,12 +8,12 @@ export const EXECUTION_MODE_CONTROL_OPTIONS = [
     {
         value: 'worktree',
         label: 'Isolated worktree',
-        description: 'Creates or reuses a per-conversation git worktree under ~/.canon/conversation-worktrees when the selected project is a git repo.',
+        description: 'Best-effort git worktree for this conversation. This is not a security sandbox; if unavailable, Canon may fall back to the shared project.',
     },
     {
         value: 'locked',
         label: 'Use shared project',
-        description: 'Runs directly in the selected project folder. Changes happen there.',
+        description: 'Runs directly in the selected project folder. File changes happen there.',
     },
 ];
 export function buildRuntimeWorkspaceControlOptions(workspaces) {

package/dist/types.d.ts

@@ -616,6 +616,7 @@ export interface SessionConfig {
 export interface PermissionModeOption {
     value: string;
     label: string;
+    description?: string;
 }
 export declare const CLAUDE_PERMISSION_MODE_OPTIONS: readonly [{
     readonly value: "default";

package/package.json

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