@canonmsg/core 0.15.4 → 0.15.5

package/dist/agent-session.d.ts

@@ -1,6 +1,5 @@
 import type { AgentRuntime, AgentSessionSnapshot, SessionConfig, SessionState } from './types.js';
 import type { TurnState } from './turn-protocol.js';
-import { type CanonWorkSessionContext } from './work-session.js';
 export interface BuildAgentSessionSnapshotInput {
     conversationId: string;
     agentId: string;
@@ -8,8 +7,6 @@ export interface BuildAgentSessionSnapshotInput {
     sessionConfig?: SessionConfig | null;
     sessionState?: SessionState | null;
     turnState?: TurnState | null;
-    workSession?: CanonWorkSessionContext | null;
-    workSessions?: CanonWorkSessionContext[] | null;
     lastHeartbeatAt?: number | null;
     updatedAt?: number | null;
 }

package/dist/agent-session.js

@@ -1,4 +1,3 @@
-import { mergeWorkSessionContexts, } from './work-session.js';
 function listDescriptorControls(runtime) {
     const descriptor = runtime?.runtimeDescriptor;
     return [
@@ -16,20 +15,6 @@ function descriptorDefaultValue(runtime, controlId) {
         .find((candidate) => candidate.id === controlId);
     return control?.defaultValue ?? undefined;
 }
-function buildWorkSessionSummary(workSession, workSessions) {
-    const merged = mergeWorkSessionContexts(workSession, workSessions);
-    const primary = merged[0];
-    if (!primary?.id) {
-        return null;
-    }
-    return {
-        count: merged.length,
-        id: primary.id,
-        title: primary.title ?? null,
-        objective: primary.objective ?? null,
-        status: primary.status ?? null,
-    };
-}
 function setControlState(controlState, id, value, source, appliedAt) {
     if (value === undefined)
         return;
@@ -154,7 +139,6 @@ export function buildAgentSessionSnapshot(input) {
         lastHeartbeatAt: input.lastHeartbeatAt
             ?? input.runtime?.updatedAt
             ?? input.sessionState?.updatedAt,
-        workSession: buildWorkSessionSummary(input.workSession, input.workSessions),
         updatedAt: input.updatedAt
             ?? input.turnState?.updatedAt
             ?? input.sessionState?.updatedAt

package/dist/browser.d.ts

@@ -1,11 +1,11 @@
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
 export { resolveCanonBaseUrl } from './base-url.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
-export type { AddMemberResult, AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentSessionWorkSessionSummary, AgentRuntime, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { AddMemberResult, AgentCapabilities, AgentClientType, AgentSessionSnapshot, AgentRuntime, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonStreamEvent, CreateContactRequestResult, MediaAttachment, MediaAttachmentKind, ModelOption, PermissionModeOption, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, RuntimeUpdatedPayload, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, ResolvedAdmission, SessionConfig, TurnUpdatedPayload, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
 export { EXECUTION_ENVIRONMENT_MODES, isExecutionEnvironmentMode, } from './execution-environment-mode.js';
 export type { ExecutionEnvironmentMode } from './execution-environment-mode.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 { CanonSelfContext, CanonSelfContextType, SelfContextPromptRenderOptions, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, } from './self-context.js';
+export { buildSelfContextPromptLines, normalizeSelfContexts, } from './self-context.js';
 export { buildAgentSessionSnapshot } from './agent-session.js';
 export { CLAUDE_EFFORT_OPTIONS, EXECUTION_MODE_CONTROL_OPTIONS, buildFirstPartyCodingRuntimeDescriptor, buildRuntimeEffortControl, buildRuntimeExecutionModeControl, buildRuntimeExecutionModeOptions, buildRuntimeModelControl, buildRuntimePermissionModeControl, buildRuntimeWorkspaceControl, buildRuntimeWorkspaceControlOptions, } from './runtime-descriptor.js';
 export type { AgentBehaviorSettings, ParticipationHistoryMessage, ParticipationHistorySnapshot, ParticipationStyle, ResolvedAgentBehaviorPolicy, } from './policy.js';

package/dist/browser.js

@@ -2,7 +2,7 @@ export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js'
 export { resolveCanonBaseUrl } from './base-url.js';
 export { DEFAULT_BASE_URL, DEFAULT_STREAM_URL, DEFAULT_RTDB_URL, FIREBASE_WEB_API_KEY } from './constants.js';
 export { EXECUTION_ENVIRONMENT_MODES, isExecutionEnvironmentMode, } from './execution-environment-mode.js';
-export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
+export { buildSelfContextPromptLines, normalizeSelfContexts, } from './self-context.js';
 export { buildAgentSessionSnapshot } from './agent-session.js';
 export { CLAUDE_EFFORT_OPTIONS, EXECUTION_MODE_CONTROL_OPTIONS, buildFirstPartyCodingRuntimeDescriptor, buildRuntimeEffortControl, buildRuntimeExecutionModeControl, buildRuntimeExecutionModeOptions, buildRuntimeModelControl, buildRuntimePermissionModeControl, buildRuntimeWorkspaceControl, buildRuntimeWorkspaceControlOptions, } from './runtime-descriptor.js';
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { type CanonMessage, type CanonConversation, type CanonContact, type CanonContactRequest, type CanonMessagesPage, type CanonResolveAdmissionResult, type AgentContext, type AddMemberResult, type CreateContactRequestResult, 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 { SendContextualMessageOptions, SendContextualMessageResult } from './self-context.js';
 import type { InboundDisposition } from './turn-protocol.js';
 /**
  * Thin REST client for Canon's agent API.
@@ -25,10 +25,7 @@ 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>;
+    sendContextualMessage(options: SendContextualMessageOptions): Promise<SendContextualMessageResult>;
     createConversation(options: CreateConversationOptions): Promise<{
         conversationId: string;
     }>;

package/dist/client.js

@@ -82,8 +82,8 @@ 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`, {
+    async sendContextualMessage(options) {
+        const res = await fetch(`${this.baseUrl}/messages/send-contextual`, {
             method: 'POST',
             headers: this.authHeaders(),
             body: JSON.stringify(options),
@@ -92,44 +92,6 @@ export class CanonClient {
             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/host-runtime.d.ts

@@ -33,8 +33,7 @@ export declare function buildCanonHostPrompt(input: {
     conversationId: string;
     participantContext: HostInboundParticipantContext;
     behavior?: ResolvedAgentBehaviorPolicy | null;
-    workSession?: MessageCreatedPayload['message']['workSession'];
-    workSessions?: MessageCreatedPayload['workSessions'];
+    selfContexts?: MessageCreatedPayload['selfContexts'];
     buildInboundContextLines: (context: HostInboundParticipantContext) => string[];
     sessionContextLines?: string[];
 }): string;
@@ -68,7 +67,7 @@ export declare function buildHydratedInboundContext(input: {
 }): {
     participantContext: HostInboundParticipantContext;
     behavior?: ResolvedAgentBehaviorPolicy | null;
-    workSessions: NonNullable<MessageCreatedPayload['workSessions']>;
+    selfContexts: NonNullable<MessageCreatedPayload['selfContexts']>;
     hydratedFromPage: boolean;
 };
 export declare function publishHostAgentRuntime(agentId: string, clientType: AgentClientType, runtime: AgentRuntime): Promise<void>;

package/dist/host-runtime.js

@@ -1,7 +1,7 @@
 import { buildAgentSessionSnapshot } from './agent-session.js';
 import { buildConversationWorktreeSpec, normalizeOptionalString, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, } from './execution-environment.js';
 import { buildBehaviorPolicyLines, buildParticipationHistorySnapshot, } from './policy.js';
-import { buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
+import { buildSelfContextPromptLines, normalizeSelfContexts, } from './self-context.js';
 import { rtdbRead } from './rtdb-rest.js';
 import { createRuntimeStatePublisher } from './runtime-state-publisher.js';
 const HOST_INBOUND_CONTACT_CARD_ACTION_CAPABILITIES = Object.freeze({
@@ -11,18 +11,18 @@ const HOST_INBOUND_CONTACT_CARD_ACTION_CAPABILITIES = Object.freeze({
     canRejectPendingContactRequests: false,
 });
 export function buildCanonHostPrompt(input) {
-    const resolvedWorkSessions = mergeWorkSessionContexts(input.workSession, input.workSessions);
+    const resolvedSelfContexts = normalizeSelfContexts(input.selfContexts);
     return [
         `You are connected to Canon messaging through a ${input.hostLabel} host wrapper.`,
         'Only the last assistant message from this turn will be delivered as the permanent Canon reply.',
         'Short intermediate assistant messages may be shown as ephemeral status while you work.',
         ...input.buildInboundContextLines(input.participantContext),
         ...buildBehaviorPolicyLines(input.behavior),
-        ...buildWorkSessionsPromptLines(resolvedWorkSessions),
+        ...buildSelfContextPromptLines(resolvedSelfContexts),
         'Canon participants may be humans or AI agents.',
         'Honor the Canon behavior policy above when deciding how proactively to participate.',
-        ...(resolvedWorkSessions.length > 0
-            ? ['Honor the Canon work-session context above within its stated disclosure limits.']
+        ...(resolvedSelfContexts.length > 0
+            ? ['Honor the Canon self-context above when continuing your own cross-session action.']
             : []),
         ...(input.sessionContextLines?.length
             ? ['Canon session state:', ...input.sessionContextLines]
@@ -117,7 +117,7 @@ export function buildHydratedInboundContext(input) {
             currentAgentStreakStartedByHuman: history.currentAgentStreakStartedByHuman,
         },
         behavior: input.page?.behavior ?? input.conversation?.behavior,
-        workSessions: input.page?.workSessions ?? [],
+        selfContexts: input.page?.selfContexts ?? [],
         hydratedFromPage: input.page != null,
     };
 }

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
-export type { AddMemberResult, AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, AgentSessionWorkSessionSummary, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, WorkspaceOption, WorkspaceOptionSource, } 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 type { AddMemberResult, AgentCapabilities, AgentClientType, CanonControlAvailability, CanonControlDescriptor, CanonControlLiveBehavior, CanonControlSelectionPolicy, CanonControlValue, CanonContact, CanonContactRequest, CanonContactRequestStatus, CanonResolveAdmissionResult, ContactAddedPayload, ContactApprovedPayload, ContactCardPayload, ContactRemovedPayload, ContactRequestPayload, ContactSource, ResolvedAdmissionState, ResolvedAdmissionTargetSummary, ResolvedTargetAdmissionPayload, CanonMessage, CanonConversation, CanonMessagesPage, CreateContactRequestResult, AgentContext, CanonStreamEvent, AgentSessionSnapshot, ResolvedAdmission, MediaAttachment, MediaAttachmentKind, MessageCreatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, TurnUpdatedPayload, SendMessageOptions, CreateConversationOptions, RegistrationInput, RegistrationResult, RegistrationStatus, StreamingStatus, SetStreamingOptions, SessionControl, SessionState, SessionConfig, AgentRuntime, CanonRuntimeDescriptor, CanonRuntimeActionAvailability, CanonRuntimeActionCategory, CanonRuntimeActionDescriptor, CanonRuntimeActionDispatch, CanonRuntimeActionPlacement, CanonRuntimeDetailTier, CanonRuntimeExecutionMetadata, CanonRuntimeInventory, CanonRuntimeInventoryEntry, CanonRuntimeStreamingMode, CanonRuntimeStatusItem, CanonRuntimeSurfaceMode, CanonWorkspaceRootMetadata, ModelOption, PermissionModeOption, RuntimeInfoPayload, RuntimeControlError, RuntimeControlState, RuntimeControlValueSource, WorkspaceOption, WorkspaceOptionSource, } from './types.js';
+export type { CanonSelfContext, CanonSelfContextType, SelfContextPromptRenderOptions, SendContextualMessageOptions, SendContextualMessageResult, SendContextualSelfContextInput, } from './self-context.js';
+export { buildSelfContextPromptLines, normalizeSelfContexts, } from './self-context.js';
 export { buildConfiguredWorkspaceOptionsWithRoots, buildPublicWorkspaceRoots, buildWorkspaceRootId, discoverWorkspaceProjects, } from './workspace-discovery.js';
 export type { ConfiguredWorkspaceRoot, WorkspaceDiscoveryResult, } from './workspace-discovery.js';
 export { CanonClient, CanonApiError } from './client.js';
@@ -9,7 +9,7 @@ export { buildAgentSessionSnapshot } from './agent-session.js';
 export { CLAUDE_EFFORT_OPTIONS, EXECUTION_MODE_CONTROL_OPTIONS, buildFirstPartyCodingRuntimeDescriptor, buildRuntimeEffortControl, buildRuntimeExecutionModeControl, buildRuntimeExecutionModeOptions, buildRuntimeModelControl, buildRuntimePermissionModeControl, buildRuntimeWorkspaceControl, buildRuntimeWorkspaceControlOptions, } from './runtime-descriptor.js';
 export { CanonStream } from './stream.js';
 export type { StreamHandler } from './stream.js';
-export type { PolicyRole, ParticipationStyle, RepresentationMode, PermissionLevel, ConversationScope, AgentBehaviorSettings, Participant, Relationship, ContextOverlay, BehaviorProfile, AdmissionPolicy, RuntimeControlPolicy, ActionApprovalPolicy, ParticipationPolicy, WorkSession, ResolvedPolicy, ResolvedTurnEligibility, ResolvedAgentBehaviorPolicy, ParticipationHistoryMessage, ParticipationHistorySnapshot, ParticipationDecisionInput, ParticipationDecision, } from './policy.js';
+export type { PolicyRole, ParticipationStyle, RepresentationMode, PermissionLevel, ConversationScope, AgentBehaviorSettings, Participant, Relationship, ContextOverlay, BehaviorProfile, AdmissionPolicy, RuntimeControlPolicy, ActionApprovalPolicy, ParticipationPolicy, ResolvedPolicy, ResolvedTurnEligibility, ResolvedAgentBehaviorPolicy, ParticipationHistoryMessage, ParticipationHistorySnapshot, ParticipationDecisionInput, ParticipationDecision, } from './policy.js';
 export { buildParticipationHistorySnapshot, buildParticipationHistorySnapshots, buildBehaviorPolicyLines, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, evaluateParticipationPolicy, getDefaultParticipationPolicy, resolveAgentBehaviorPolicy, } from './policy.js';
 export { DEFAULT_RUNTIME_CAPABILITIES, HOST_ADMISSION_ACTION_CAPABILITIES, HOST_ADMISSION_ACTIONS_DISABLED, FINAL_MESSAGE_HANDOFF_MS, isTurnOpen, normalizeTurnMetadata, normalizeTurnState, resolveTurnMessageSemantics, shouldPromoteConversationMessage, shouldTriggerAgentTurn, } from './turn-protocol.js';
 export type { DeliveryIntent, TurnMessageSemantics, InboundDisposition, TurnLifecycleState, RuntimeCapabilities, HostAdmissionActionCapabilities, TurnState, TurnMetadata, TriggerDecision, } from './turn-protocol.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 // Types
 export { AGENT_CAPABILITIES, CLAUDE_PERMISSION_MODE_OPTIONS, } from './types.js';
-export { buildWorkSessionPromptLines, buildWorkSessionsPromptLines, mergeWorkSessionContexts, } from './work-session.js';
+export { buildSelfContextPromptLines, normalizeSelfContexts, } from './self-context.js';
 export { buildConfiguredWorkspaceOptionsWithRoots, buildPublicWorkspaceRoots, buildWorkspaceRootId, discoverWorkspaceProjects, } from './workspace-discovery.js';
 // Client
 export { CanonClient, CanonApiError } from './client.js';

package/dist/policy.d.ts

@@ -67,16 +67,6 @@ export interface ParticipationPolicy {
     requireMentionForGroupReplies: boolean;
     maxConsecutiveAgentTurns?: number | null;
 }
-export interface WorkSession {
-    id: string;
-    conversationId?: string | null;
-    label?: string | null;
-    objective?: string | null;
-    participationStyle?: ParticipationStyle;
-    activeParticipantIds: string[];
-    overlayIds?: string[];
-    status: "active" | "paused" | "completed";
-}
 export interface ResolvedPolicy {
     admission: AdmissionPolicy;
     runtime: RuntimeControlPolicy;
@@ -90,7 +80,6 @@ export interface ResolvedPolicy {
         globalDefault?: string;
         agentDefault?: string;
         relationship?: string;
-        workSession?: string;
         messageDirective?: string;
     };
 }

package/dist/rtdb-rest.d.ts

@@ -91,13 +91,6 @@ export interface AgentSessionSnapshotPatch {
     lastHeartbeatAt?: number | {
         '.sv': 'timestamp';
     };
-    workSession?: {
-        count: number;
-        id: string;
-        title?: string | null;
-        objective?: string | null;
-        status?: string | null;
-    } | null;
     updatedAt?: {
         '.sv': 'timestamp';
     };

package/dist/self-context.d.ts

@@ -0,0 +1,39 @@
+export type CanonSelfContextType = 'cross_session';
+export interface CanonSelfContext {
+    id: string;
+    type: CanonSelfContextType;
+    context: string;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface SendContextualSelfContextInput {
+    type: CanonSelfContextType;
+    context: string;
+}
+export interface SendContextualMessageOptions {
+    sourceConversationId: string;
+    targetConversationId?: string;
+    targetUserId?: string;
+    text: string;
+    selfContext: SendContextualSelfContextInput;
+    sessionConfig?: import('./types.js').SessionConfig | null;
+    requestMessage?: string | null;
+    messageOptions?: Omit<import('./types.js').SendMessageOptions, 'selfContextId' | 'selfContext'>;
+}
+export type SendContextualMessageResult = {
+    status: 'messaged';
+    messageId: string;
+    conversationId: string;
+    selfContextId: string;
+} | {
+    status: 'requested' | 'pending';
+    requestId: string | null;
+} | {
+    status: 'setup_required' | 'blocked' | 'unavailable';
+    reason: string;
+};
+export interface SelfContextPromptRenderOptions {
+    maxSelfContexts?: number;
+}
+export declare function normalizeSelfContexts(selfContexts?: CanonSelfContext[] | null, options?: SelfContextPromptRenderOptions): CanonSelfContext[];
+export declare function buildSelfContextPromptLines(selfContexts?: CanonSelfContext[] | null, options?: SelfContextPromptRenderOptions): string[];

package/dist/self-context.js

@@ -0,0 +1,66 @@
+const DEFAULT_SELF_CONTEXT_PROMPT_OPTIONS = {
+    maxSelfContexts: 3,
+};
+function normalizeString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function resolvePromptOptions(options) {
+    return {
+        maxSelfContexts: Math.max(1, options?.maxSelfContexts ?? DEFAULT_SELF_CONTEXT_PROMPT_OPTIONS.maxSelfContexts),
+    };
+}
+function contextSortTime(context) {
+    const updatedAt = normalizeString(context.updatedAt);
+    if (updatedAt) {
+        const parsed = new Date(updatedAt).getTime();
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    const createdAt = normalizeString(context.createdAt);
+    if (createdAt) {
+        const parsed = new Date(createdAt).getTime();
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return 0;
+}
+export function normalizeSelfContexts(selfContexts, options) {
+    if (!Array.isArray(selfContexts))
+        return [];
+    const promptOptions = resolvePromptOptions(options);
+    const byId = new Map();
+    for (const selfContext of selfContexts) {
+        const id = normalizeString(selfContext?.id);
+        const context = normalizeString(selfContext?.context);
+        if (!id || !context || selfContext.type !== 'cross_session')
+            continue;
+        byId.set(id, {
+            id,
+            type: 'cross_session',
+            context,
+            createdAt: normalizeString(selfContext.createdAt),
+            updatedAt: normalizeString(selfContext.updatedAt),
+        });
+    }
+    return [...byId.values()]
+        .sort((left, right) => contextSortTime(right) - contextSortTime(left))
+        .slice(0, promptOptions.maxSelfContexts);
+}
+export function buildSelfContextPromptLines(selfContexts, options) {
+    const resolved = normalizeSelfContexts(selfContexts, options);
+    if (resolved.length === 0)
+        return [];
+    const lines = ['Canon cross-session self-context for you:'];
+    resolved.forEach((selfContext, index) => {
+        if (resolved.length > 1) {
+            lines.push(`Self-context ${index + 1}:`);
+        }
+        lines.push(`Context type: ${selfContext.type}.`);
+        lines.push(`Why you are speaking in this conversation: ${selfContext.context}`);
+    });
+    lines.push('Canon rule: this self-context explains your own prior cross-session action; it does not grant access to the source transcript. Keep Canon sessions separate.');
+    return lines;
+}

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { ExecutionEnvironmentMode } from './execution-environment-mode.js';
 import type { ResolvedAgentBehaviorPolicy } from './policy.js';
 import type { TurnLifecycleState } from './turn-protocol.js';
-import type { CanonWorkSessionContext } from './work-session.js';
+import type { CanonSelfContext } from './self-context.js';
 export type { ExecutionEnvironmentMode };
 export type MediaAttachmentKind = 'image' | 'audio' | 'file';
 export interface MediaAttachment {
@@ -51,7 +51,6 @@ export interface CanonMessage {
     replyToPosition: number | null;
     forwarded?: boolean;
     forwardedFrom?: ForwardedFrom;
-    workSession?: CanonWorkSessionContext | null;
     metadata?: Record<string, unknown>;
     contactCard?: ContactCardPayload;
     status: 'sent' | 'read';
@@ -78,7 +77,7 @@ export interface CanonConversation {
 export interface CanonMessagesPage {
     messages: CanonMessage[];
     behavior?: ResolvedAgentBehaviorPolicy;
-    workSessions?: CanonWorkSessionContext[];
+    selfContexts?: CanonSelfContext[];
 }
 export type CanonContactRequestStatus = 'pending' | 'approved' | 'rejected' | 'expired';
 export interface CanonContactRequest {
@@ -355,7 +354,7 @@ export interface AgentContext {
 export interface MessageCreatedPayload {
     conversationId: string;
     behavior?: ResolvedAgentBehaviorPolicy;
-    workSessions?: CanonWorkSessionContext[];
+    selfContexts?: CanonSelfContext[];
     message: {
         id: string;
         senderId: string;
@@ -372,7 +371,6 @@ export interface MessageCreatedPayload {
         forwardedFrom?: ForwardedFrom;
         mentions?: string[];
         createdAt?: string;
-        workSession?: CanonWorkSessionContext | null;
         /** Structured metadata for rich UI (approval cards, etc.) */
         metadata?: Record<string, unknown>;
         /** Populated when `contentType === 'contact_card'`. */
@@ -453,7 +451,7 @@ export interface SendMessageOptions {
     attachments?: MediaAttachment[];
     contactCardUserId?: string;
     mentions?: string[];
-    workSessionId?: string;
+    selfContextId?: string;
     /** Structured metadata for rich UI (approval cards, etc.) */
     metadata?: Record<string, unknown>;
 }
@@ -577,13 +575,6 @@ export interface AgentRuntime {
     availableWorkspaces?: WorkspaceOption[];
     updatedAt?: number;
 }
-export interface AgentSessionWorkSessionSummary {
-    count: number;
-    id: string;
-    title?: string | null;
-    objective?: string | null;
-    status?: CanonWorkSessionContext['status'] | null;
-}
 export interface AgentSessionSnapshot {
     conversationId: string;
     agentId: string;
@@ -615,7 +606,6 @@ export interface AgentSessionSnapshot {
     contextUsage?: SessionState['contextUsage'];
     lastError?: string;
     lastHeartbeatAt?: number;
-    workSession?: AgentSessionWorkSessionSummary | null;
     updatedAt?: number;
 }
 export interface RegistrationInput {

package/package.json

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

package/dist/work-session.d.ts

@@ -1,88 +0,0 @@
-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

@@ -1,238 +0,0 @@
-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;
-}