@canonmsg/core 0.4.0 → 0.6.0

package/dist/browser.d.ts

@@ -1,5 +1,7 @@
 export { AGENT_CAPABILITIES, } from './types.js';
 export type { AgentCapabilities, AgentClientType, AgentRuntime, MediaAttachment, MediaAttachmentKind, ModelOption, SessionConfig, WorkspaceOption, } from './types.js';
+export type { CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, CreateWorkSessionOptions, SendLinkedMessageOptions, SendLinkedMessageResult, UpdateWorkSessionConversationOptions, WorkSessionPromptRenderOptions, } from './work-session.js';
+export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
 export type { AgentBehaviorSettings, ParticipationHistoryMessage, ParticipationHistorySnapshot, ParticipationStyle, ResolvedAgentBehaviorPolicy, } from './policy.js';
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';
 export { DEFAULT_RUNTIME_CAPABILITIES, FINAL_MESSAGE_HANDOFF_MS, isTurnOpen, normalizeTurnMetadata, normalizeTurnState, resolveTurnMessageSemantics, shouldPromoteConversationMessage, shouldTriggerAgentTurn, } from './turn-protocol.js';

package/dist/browser.js

@@ -1,3 +1,4 @@
 export { AGENT_CAPABILITIES, } from './types.js';
+export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';
 export { DEFAULT_RUNTIME_CAPABILITIES, FINAL_MESSAGE_HANDOFF_MS, isTurnOpen, normalizeTurnMetadata, normalizeTurnState, resolveTurnMessageSemantics, shouldPromoteConversationMessage, shouldTriggerAgentTurn, } from './turn-protocol.js';

package/dist/client.d.ts

@@ -1,4 +1,5 @@
 import { type CanonMessage, type CanonConversation, type CanonMessagesPage, type AgentContext, type MediaAttachment, type SendMessageOptions, type CreateConversationOptions, type RegistrationStatus, type SetStreamingOptions } from './types.js';
+import type { CanonResolvedWorkSession, CreateWorkSessionOptions, SendLinkedMessageOptions, SendLinkedMessageResult, UpdateWorkSessionConversationOptions } from './work-session.js';
 import type { InboundDisposition } from './turn-protocol.js';
 /**
  * Thin REST client for Canon's agent API.
@@ -21,6 +22,10 @@ export declare class CanonClient {
     sendMessage(conversationId: string, text: string, options?: SendMessageOptions): Promise<{
         messageId: string;
     }>;
+    createWorkSession(options: CreateWorkSessionOptions): Promise<CanonResolvedWorkSession>;
+    getWorkSession(workSessionId: string, conversationId: string): Promise<CanonResolvedWorkSession>;
+    upsertWorkSessionConversation(workSessionId: string, conversationId: string, options?: UpdateWorkSessionConversationOptions): Promise<CanonResolvedWorkSession>;
+    sendLinkedMessage(options: SendLinkedMessageOptions): Promise<SendLinkedMessageResult>;
     createConversation(options: CreateConversationOptions): Promise<{
         conversationId: string;
     }>;
@@ -47,6 +52,7 @@ export declare class CanonClient {
         developerInfo: string;
         avatarUrl?: string;
         clientType?: string;
+        requestedAgentId?: string;
     }): Promise<{
         requestId: string;
     }>;

package/dist/client.js

@@ -73,6 +73,54 @@ export class CanonClient {
             throw new CanonApiError(res.status, await res.text());
         return res.json();
     }
+    async createWorkSession(options) {
+        const res = await fetch(`${this.baseUrl}/work-sessions`, {
+            method: 'POST',
+            headers: this.authHeaders(),
+            body: JSON.stringify(options),
+        });
+        if (!res.ok)
+            throw new CanonApiError(res.status, await res.text());
+        return res.json();
+    }
+    async getWorkSession(workSessionId, conversationId) {
+        const params = new URLSearchParams({ conversationId });
+        const res = await fetch(`${this.baseUrl}/work-sessions/${workSessionId}?${params}`, { headers: this.authHeaders() });
+        if (!res.ok)
+            throw new CanonApiError(res.status, await res.text());
+        return res.json();
+    }
+    async upsertWorkSessionConversation(workSessionId, conversationId, options) {
+        const res = await fetch(`${this.baseUrl}/work-sessions/${workSessionId}/conversations/${conversationId}`, {
+            method: 'PUT',
+            headers: this.authHeaders(),
+            body: JSON.stringify(options ?? {}),
+        });
+        if (!res.ok)
+            throw new CanonApiError(res.status, await res.text());
+        return res.json();
+    }
+    async sendLinkedMessage(options) {
+        const res = await fetch(`${this.baseUrl}/messages/send-linked`, {
+            method: 'POST',
+            headers: this.authHeaders(),
+            body: JSON.stringify({
+                sourceConversationId: options.sourceConversationId,
+                targetConversationId: options.targetConversationId,
+                text: options.text,
+                ...(options.workSessionId ? { workSessionId: options.workSessionId } : {}),
+                ...(options.createWorkSession
+                    ? { createWorkSession: options.createWorkSession }
+                    : {}),
+                ...(options.sourceContext ? { sourceContext: options.sourceContext } : {}),
+                ...(options.targetContext ? { targetContext: options.targetContext } : {}),
+                ...(options.messageOptions ? { messageOptions: options.messageOptions } : {}),
+            }),
+        });
+        if (!res.ok)
+            throw new CanonApiError(res.status, await res.text());
+        return res.json();
+    }
     async createConversation(options) {
         const res = await fetch(`${this.baseUrl}/conversations/create`, {
             method: 'POST',

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { AGENT_CAPABILITIES, } from './types.js';
 export type { AgentCapabilities, AgentClientType, CanonMessage, CanonConversation, CanonMessagesPage, AgentContext, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, ModelOption, WorkspaceOption, } from './types.js';
+export type { CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CreateWorkSessionOptions, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, SendLinkedMessageOptions, SendLinkedMessageResult, UpdateWorkSessionConversationOptions, WorkSessionPromptRenderOptions, } from './work-session.js';
+export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
 export { CanonClient, CanonApiError } from './client.js';
 export { CanonStream } from './stream.js';
 export type { StreamHandler } from './stream.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 // Types
 export { AGENT_CAPABILITIES, } from './types.js';
+export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
 // Client
 export { CanonClient, CanonApiError } from './client.js';
 // Stream

package/dist/registration.js

@@ -17,6 +17,7 @@ export async function registerAndWaitForApproval(input, callbacks) {
         developerInfo: input.developerInfo || 'Canon agent',
         avatarUrl: input.avatarUrl,
         clientType: input.clientType,
+        requestedAgentId: input.requestedAgentId,
     });
     callbacks?.onSubmitted?.(requestId);
     const deadline = Date.now() + POLL_TIMEOUT_MS;

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { ResolvedAgentBehaviorPolicy } from './policy.js';
+import type { CanonWorkSessionContext } from './work-session.js';
 export type MediaAttachmentKind = 'image' | 'audio' | 'file';
 export interface MediaAttachment {
     kind: MediaAttachmentKind;
@@ -25,6 +26,7 @@ export interface CanonMessage {
     mentions: string[];
     replyTo: string | null;
     replyToPosition: number | null;
+    workSession?: CanonWorkSessionContext | null;
     metadata?: Record<string, unknown>;
     status: 'sent' | 'read';
     deleted: boolean;
@@ -50,6 +52,7 @@ export interface CanonConversation {
 export interface CanonMessagesPage {
     messages: CanonMessage[];
     behavior?: ResolvedAgentBehaviorPolicy;
+    workSessions?: CanonWorkSessionContext[];
 }
 export type AgentClientType = 'claude-code' | 'openclaw' | 'codex' | 'generic';
 /** Declares what session controls an agent type supports. */
@@ -88,6 +91,7 @@ export interface AgentContext {
 export interface MessageCreatedPayload {
     conversationId: string;
     behavior?: ResolvedAgentBehaviorPolicy;
+    workSessions?: CanonWorkSessionContext[];
     message: {
         id: string;
         senderId: string;
@@ -105,6 +109,7 @@ export interface MessageCreatedPayload {
         replyToPosition?: number;
         mentions?: string[];
         createdAt?: string;
+        workSession?: CanonWorkSessionContext | null;
         /** Structured metadata for rich UI (approval cards, etc.) */
         metadata?: Record<string, unknown>;
     };
@@ -129,6 +134,7 @@ export interface SendMessageOptions {
     attachments?: MediaAttachment[];
     contactCardUserId?: string;
     mentions?: string[];
+    workSessionId?: string;
     /** Structured metadata for rich UI (approval cards, etc.) */
     metadata?: Record<string, unknown>;
 }
@@ -202,6 +208,7 @@ export interface RegistrationInput {
     avatarUrl?: string;
     baseUrl?: string;
     clientType?: AgentClientType;
+    requestedAgentId?: string;
 }
 export interface RegistrationResult {
     status: 'approved' | 'rejected' | 'timeout';

package/dist/work-session.d.ts

@@ -0,0 +1,88 @@
+import type { RepresentationMode } from './policy.js';
+import type { SendMessageOptions } from './types.js';
+export type CanonWorkSessionStatus = 'active' | 'paused' | 'completed';
+export type CanonWorkSessionConversationRole = 'requester' | 'coordinator' | 'participant' | 'delegate' | 'observer';
+export type CanonWorkSessionDisclosureMode = 'none' | 'summary' | 'full';
+export interface CanonWorkSessionParticipant {
+    conversationId?: string | null;
+    participantId?: string | null;
+    label?: string | null;
+    role?: CanonWorkSessionConversationRole | null;
+}
+export interface CanonWorkSessionContext {
+    id: string;
+    title?: string | null;
+    objective?: string | null;
+    status?: CanonWorkSessionStatus | null;
+    summary?: string | null;
+    representation?: RepresentationMode | null;
+    currentConversationRole?: CanonWorkSessionConversationRole | null;
+    sourceConversationId?: string | null;
+    sourceConversationLabel?: string | null;
+    sourceParticipantId?: string | null;
+    sourceParticipantLabel?: string | null;
+    disclosure?: CanonWorkSessionDisclosureMode | null;
+    disclosureNotes?: string[];
+    visibleFacts?: string[];
+    pendingQuestions?: string[];
+    participants?: CanonWorkSessionParticipant[];
+    updatedAt?: string | null;
+}
+export interface CanonWorkSession {
+    id: string;
+    title?: string | null;
+    objective?: string | null;
+    status: CanonWorkSessionStatus;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface UpdateWorkSessionConversationOptions {
+    summary?: string | null;
+    representation?: RepresentationMode | null;
+    currentConversationRole?: CanonWorkSessionConversationRole | null;
+    sourceConversationId?: string | null;
+    sourceConversationLabel?: string | null;
+    sourceParticipantId?: string | null;
+    sourceParticipantLabel?: string | null;
+    disclosure?: CanonWorkSessionDisclosureMode | null;
+    disclosureNotes?: string[];
+    visibleFacts?: string[];
+    pendingQuestions?: string[];
+    participants?: CanonWorkSessionParticipant[];
+}
+export interface CreateWorkSessionOptions extends UpdateWorkSessionConversationOptions {
+    conversationId: string;
+    title?: string | null;
+    objective?: string | null;
+    status?: CanonWorkSessionStatus | null;
+}
+export interface CanonResolvedWorkSession {
+    workSession: CanonWorkSession;
+    context: CanonWorkSessionContext;
+}
+export interface SendLinkedMessageOptions {
+    sourceConversationId: string;
+    targetConversationId: string;
+    text: string;
+    workSessionId?: string;
+    createWorkSession?: Omit<CreateWorkSessionOptions, 'conversationId'>;
+    sourceContext?: UpdateWorkSessionConversationOptions;
+    targetContext?: UpdateWorkSessionConversationOptions;
+    messageOptions?: Omit<SendMessageOptions, 'workSessionId'>;
+}
+export interface SendLinkedMessageResult {
+    messageId: string;
+    workSessionId: string;
+    workSessionCreated: boolean;
+}
+export interface WorkSessionPromptRenderOptions {
+    maxVisibleFacts?: number;
+    maxPendingQuestions?: number;
+    maxDisclosureNotes?: number;
+    maxParticipants?: number;
+    maxDetailedWorkSessions?: number;
+    maxOtherWorkSessions?: number;
+}
+export declare function mergeWorkSessionContexts(explicitWorkSession?: CanonWorkSessionContext | null, activeWorkSessions?: CanonWorkSessionContext[] | null): CanonWorkSessionContext[];
+export declare function buildWorkSessionPromptLines(workSession?: CanonWorkSessionContext | null, options?: WorkSessionPromptRenderOptions): string[];
+export declare function buildWorkSessionsPromptLines(workSessions?: CanonWorkSessionContext[] | null, options?: WorkSessionPromptRenderOptions): string[];

package/dist/work-session.js

@@ -0,0 +1,238 @@
+const DEFAULT_WORK_SESSION_PROMPT_OPTIONS = {
+    maxVisibleFacts: 3,
+    maxPendingQuestions: 2,
+    maxDisclosureNotes: 1,
+    maxParticipants: 3,
+    maxDetailedWorkSessions: 1,
+    maxOtherWorkSessions: 3,
+};
+function normalizeString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeStringList(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((entry) => normalizeString(entry))
+        .filter((entry) => entry != null);
+}
+function mergeStringLists(primary, secondary) {
+    const merged = [...normalizeStringList(primary), ...normalizeStringList(secondary)];
+    const unique = Array.from(new Set(merged));
+    return unique.length > 0 ? unique : undefined;
+}
+function mergeParticipants(primary, secondary) {
+    const result = [];
+    const seen = new Set();
+    const pushParticipant = (participant) => {
+        if (!participant)
+            return;
+        const key = [
+            normalizeString(participant.conversationId),
+            normalizeString(participant.participantId),
+            normalizeString(participant.label),
+            normalizeString(participant.role),
+        ].join('::');
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        result.push(participant);
+    };
+    for (const participant of primary ?? [])
+        pushParticipant(participant);
+    for (const participant of secondary ?? [])
+        pushParticipant(participant);
+    return result.length > 0 ? result : undefined;
+}
+function mergeTwoWorkSessions(primary, secondary) {
+    const disclosureNotes = mergeStringLists(primary.disclosureNotes, secondary.disclosureNotes);
+    const visibleFacts = mergeStringLists(primary.visibleFacts, secondary.visibleFacts);
+    const pendingQuestions = mergeStringLists(primary.pendingQuestions, secondary.pendingQuestions);
+    const participants = mergeParticipants(primary.participants, secondary.participants);
+    return {
+        id: primary.id,
+        title: primary.title ?? secondary.title ?? null,
+        objective: primary.objective ?? secondary.objective ?? null,
+        status: primary.status ?? secondary.status ?? null,
+        summary: primary.summary ?? secondary.summary ?? null,
+        representation: primary.representation ?? secondary.representation ?? null,
+        currentConversationRole: primary.currentConversationRole ?? secondary.currentConversationRole ?? null,
+        sourceConversationId: primary.sourceConversationId ?? secondary.sourceConversationId ?? null,
+        sourceConversationLabel: primary.sourceConversationLabel ?? secondary.sourceConversationLabel ?? null,
+        sourceParticipantId: primary.sourceParticipantId ?? secondary.sourceParticipantId ?? null,
+        sourceParticipantLabel: primary.sourceParticipantLabel ?? secondary.sourceParticipantLabel ?? null,
+        disclosure: primary.disclosure ?? secondary.disclosure ?? null,
+        ...(disclosureNotes ? { disclosureNotes } : {}),
+        ...(visibleFacts ? { visibleFacts } : {}),
+        ...(pendingQuestions ? { pendingQuestions } : {}),
+        ...(participants ? { participants } : {}),
+        updatedAt: primary.updatedAt ?? secondary.updatedAt ?? null,
+    };
+}
+export function mergeWorkSessionContexts(explicitWorkSession, activeWorkSessions) {
+    const merged = new Map();
+    const add = (workSession) => {
+        if (!workSession?.id)
+            return;
+        const existing = merged.get(workSession.id);
+        merged.set(workSession.id, existing ? mergeTwoWorkSessions(existing, workSession) : workSession);
+    };
+    add(explicitWorkSession);
+    for (const workSession of activeWorkSessions ?? []) {
+        add(workSession);
+    }
+    return Array.from(merged.values());
+}
+function formatParticipantLabel(participant) {
+    const label = normalizeString(participant.label);
+    if (label)
+        return label;
+    const participantId = normalizeString(participant.participantId);
+    if (participantId)
+        return participantId;
+    return normalizeString(participant.conversationId);
+}
+function resolvePromptOptions(options) {
+    return {
+        maxVisibleFacts: Math.max(0, options?.maxVisibleFacts
+            ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxVisibleFacts),
+        maxPendingQuestions: Math.max(0, options?.maxPendingQuestions
+            ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxPendingQuestions),
+        maxDisclosureNotes: Math.max(0, options?.maxDisclosureNotes
+            ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxDisclosureNotes),
+        maxParticipants: Math.max(0, options?.maxParticipants ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxParticipants),
+        maxDetailedWorkSessions: Math.max(1, options?.maxDetailedWorkSessions
+            ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxDetailedWorkSessions),
+        maxOtherWorkSessions: Math.max(0, options?.maxOtherWorkSessions
+            ?? DEFAULT_WORK_SESSION_PROMPT_OPTIONS.maxOtherWorkSessions),
+    };
+}
+function takeWithHiddenCount(values, maxCount) {
+    if (maxCount <= 0) {
+        return { visible: [], hiddenCount: values.length };
+    }
+    return {
+        visible: values.slice(0, maxCount),
+        hiddenCount: Math.max(0, values.length - maxCount),
+    };
+}
+function buildOriginLabel(workSession) {
+    const sourceConversation = normalizeString(workSession.sourceConversationLabel)
+        ?? normalizeString(workSession.sourceConversationId);
+    const sourceParticipant = normalizeString(workSession.sourceParticipantLabel)
+        ?? normalizeString(workSession.sourceParticipantId);
+    if (sourceConversation && sourceParticipant) {
+        return `${sourceParticipant} in ${sourceConversation}`;
+    }
+    return sourceParticipant ?? sourceConversation;
+}
+function formatWorkSessionReference(workSession) {
+    const title = normalizeString(workSession.title);
+    const objective = normalizeString(workSession.objective);
+    if (title)
+        return `${title} (${workSession.id})`;
+    if (objective)
+        return `${objective} (${workSession.id})`;
+    return workSession.id;
+}
+export function buildWorkSessionPromptLines(workSession, options) {
+    if (!workSession)
+        return [];
+    const promptOptions = resolvePromptOptions(options);
+    const title = normalizeString(workSession.title);
+    const objective = normalizeString(workSession.objective);
+    const summary = normalizeString(workSession.summary);
+    const origin = buildOriginLabel(workSession);
+    const visibleFacts = takeWithHiddenCount(normalizeStringList(workSession.visibleFacts), promptOptions.maxVisibleFacts);
+    const pendingQuestions = takeWithHiddenCount(normalizeStringList(workSession.pendingQuestions), promptOptions.maxPendingQuestions);
+    const disclosureNotes = takeWithHiddenCount(normalizeStringList(workSession.disclosureNotes), promptOptions.maxDisclosureNotes);
+    const participants = takeWithHiddenCount(Array.isArray(workSession.participants) ? workSession.participants : [], promptOptions.maxParticipants);
+    return [
+        `Canon work session ID: ${workSession.id}`,
+        ...(title ? [`Canon work session title: ${title}`] : []),
+        ...(objective ? [`Canon work session objective: ${objective}`] : []),
+        ...(workSession.status
+            ? [`Canon work session status: ${workSession.status}`]
+            : []),
+        ...(workSession.currentConversationRole
+            ? [
+                `This conversation's role in the work session: ${workSession.currentConversationRole}`,
+            ]
+            : []),
+        ...(workSession.representation
+            ? [`Participate in this conversation as: ${workSession.representation}`]
+            : []),
+        ...(origin ? [`Work session origin: ${origin}`] : []),
+        ...(workSession.disclosure
+            ? [`Allowed disclosure level in this conversation: ${workSession.disclosure}`]
+            : []),
+        ...(summary ? [`Shared work session summary: ${summary}`] : []),
+        ...visibleFacts.visible.map((fact, index) => `Shared fact ${index + 1}: ${fact}`),
+        ...(visibleFacts.hiddenCount > 0
+            ? [`Additional shared facts omitted for brevity: ${visibleFacts.hiddenCount}`]
+            : []),
+        ...pendingQuestions.visible.map((question, index) => `Open question ${index + 1}: ${question}`),
+        ...(pendingQuestions.hiddenCount > 0
+            ? [
+                `Additional open questions omitted for brevity: ${pendingQuestions.hiddenCount}`,
+            ]
+            : []),
+        ...disclosureNotes.visible.map((note, index) => `Disclosure note ${index + 1}: ${note}`),
+        ...(disclosureNotes.hiddenCount > 0
+            ? [
+                `Additional disclosure notes omitted for brevity: ${disclosureNotes.hiddenCount}`,
+            ]
+            : []),
+        ...participants.visible.flatMap((participant, index) => {
+            const label = formatParticipantLabel(participant);
+            if (!label)
+                return [];
+            const role = normalizeString(participant.role);
+            return [
+                `Related participant ${index + 1}: ${label}${role ? ` (${role})` : ''}`,
+            ];
+        }),
+        ...(participants.hiddenCount > 0
+            ? [
+                `Additional related participants omitted for brevity: ${participants.hiddenCount}`,
+            ]
+            : []),
+        'Canon rule: this shared work-session context is scoped to this conversation only and does not grant access to other conversation transcripts.',
+    ];
+}
+export function buildWorkSessionsPromptLines(workSessions, options) {
+    const promptOptions = resolvePromptOptions(options);
+    if (!Array.isArray(workSessions) || workSessions.length === 0)
+        return [];
+    if (workSessions.length === 1) {
+        return [
+            'Canon active work session for this conversation:',
+            ...buildWorkSessionPromptLines(workSessions[0], promptOptions),
+        ];
+    }
+    const detailedWorkSessions = workSessions.slice(0, promptOptions.maxDetailedWorkSessions);
+    const hiddenWorkSessions = workSessions.slice(promptOptions.maxDetailedWorkSessions);
+    const lines = ['Canon active work sessions for this conversation:'];
+    detailedWorkSessions.forEach((workSession, index) => {
+        lines.push(detailedWorkSessions.length === 1
+            ? 'Primary active work session:'
+            : `Detailed work session ${index + 1}:`);
+        lines.push(...buildWorkSessionPromptLines(workSession, promptOptions));
+    });
+    if (hiddenWorkSessions.length > 0) {
+        lines.push('Other active work sessions linked here:');
+        hiddenWorkSessions
+            .slice(0, promptOptions.maxOtherWorkSessions)
+            .forEach((workSession, index) => {
+            lines.push(`Other work session ${index + 1}: ${formatWorkSessionReference(workSession)}`);
+        });
+        if (hiddenWorkSessions.length > promptOptions.maxOtherWorkSessions) {
+            lines.push(`Additional active work sessions omitted for brevity: ${hiddenWorkSessions.length - promptOptions.maxOtherWorkSessions}`);
+        }
+        lines.push('Canon rule: do not assume the current message refers to another linked work session unless the conversation clearly points to it.');
+    }
+    return lines;
+}

package/package.json

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