@canonmsg/agent-sdk 0.5.0 → 0.6.0

package/dist/canon-agent.js

@@ -1,4 +1,4 @@
-import { CanonClient, FINAL_MESSAGE_HANDOFF_MS, initRTDBAuth, rtdbWrite, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from '@canonmsg/core';
+import { CanonClient, FINAL_MESSAGE_HANDOFF_MS, initRTDBAuth, mergeWorkSessionContexts, rtdbWrite, writeSessionState, clearSessionState, writeTurnState, clearTurnState, } from '@canonmsg/core';
 import { randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
@@ -274,8 +274,9 @@ export class CanonAgent {
             }
         }, 3500);
         try {
-            // Fetch history from API
-            const history = await this.apiClient.getMessages(conversationId, this.options.historyLimit);
+            // Fetch hydrated history/context from API
+            const page = await this.apiClient.getMessagesPage(conversationId, this.options.historyLimit);
+            const history = page.messages;
             // If sessions enabled, seed the session with fetched history
             if (this.sessionManager && session) {
                 this.sessionManager.seedHistory(conversationId, history);
@@ -331,6 +332,11 @@ export class CanonAgent {
                     m.isOwner = m.senderId === ownerId;
                 }
             }
+            const explicitWorkSession = messages.find((message) => message.workSession)?.workSession
+                ?? history.find((message) => message.workSession)?.workSession
+                ?? null;
+            const activeWorkSessions = mergeWorkSessionContexts(explicitWorkSession, page.workSessions ?? []);
+            const workSession = explicitWorkSession;
             // Build agent context (fallback to minimal if not yet received)
             const agent = this.agentContext ?? {
                 agentId: this.agentId,
@@ -345,6 +351,23 @@ export class CanonAgent {
             const react = (messageId, emoji) => this.apiClient.react(conversationId, messageId, emoji);
             const addMember = (userId) => this.apiClient.addMember(conversationId, userId);
             const removeMember = (userId) => this.apiClient.removeMember(conversationId, userId);
+            const createWorkSession = (options) => this.apiClient.createWorkSession({
+                conversationId,
+                ...(options ?? {}),
+            });
+            const getWorkSession = (workSessionId, targetConversationId = conversationId) => this.apiClient.getWorkSession(workSessionId, targetConversationId);
+            const updateWorkSessionContext = (workSessionId, options) => this.apiClient.upsertWorkSessionConversation(workSessionId, conversationId, options);
+            const sendLinkedMessage = (targetConversationId, text, options) => {
+                if (!options?.workSessionId && !options?.createWorkSession) {
+                    throw new Error('sendLinkedMessage requires workSessionId or createWorkSession');
+                }
+                return this.apiClient.sendLinkedMessage({
+                    sourceConversationId: conversationId,
+                    targetConversationId,
+                    text,
+                    ...options,
+                });
+            };
             // Invoke handler
             await this.handler({
                 messages,
@@ -360,7 +383,13 @@ export class CanonAgent {
                 react,
                 addMember,
                 removeMember,
+                createWorkSession,
+                getWorkSession,
+                updateWorkSessionContext,
+                sendLinkedMessage,
                 agent,
+                workSession,
+                activeWorkSessions,
                 session: session
                     ? {
                         id: session.id,

package/dist/index.d.ts

@@ -2,5 +2,5 @@ export { CanonAgent } from './canon-agent.js';
 export { CanonApiError } from '@canonmsg/core';
 export { SessionManager } from './session-manager.js';
 export type { SessionConfig, Session } from './session-manager.js';
-export type { AgentContext, CanonMessage, CanonConversation, SendMessageOptions, CreateConversationOptions, } from '@canonmsg/core';
+export type { AgentContext, CanonMessage, CanonConversation, CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, CreateWorkSessionOptions, SendLinkedMessageOptions, SendLinkedMessageResult, SendMessageOptions, CreateConversationOptions, UpdateWorkSessionConversationOptions, } from '@canonmsg/core';
 export type { SDKMessage, SDKConversation, CanonAgentOptions, MessageHandler, MessageHandlerContext, ProgressMessageOptions, ProgressMessageResult, SessionInfo, SessionOptions, DeliveryMode, } from './types.js';

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-export type { AgentClientType, CanonMessage, CanonConversation, AgentContext, SendMessageOptions, CreateConversationOptions, TurnLifecycleState, } from '@canonmsg/core';
-import type { CanonMessage, CanonConversation, SendMessageOptions } from '@canonmsg/core';
+export type { AgentClientType, CanonMessage, CanonConversation, AgentContext, CanonResolvedWorkSession, CanonWorkSession, CanonWorkSessionContext, CanonWorkSessionConversationRole, CanonWorkSessionDisclosureMode, CanonWorkSessionParticipant, CanonWorkSessionStatus, CreateWorkSessionOptions, SendLinkedMessageOptions, SendLinkedMessageResult, SendMessageOptions, CreateConversationOptions, TurnLifecycleState, UpdateWorkSessionConversationOptions, } from '@canonmsg/core';
+import type { CanonMessage, CanonConversation, CreateWorkSessionOptions, SendMessageOptions, UpdateWorkSessionConversationOptions } from '@canonmsg/core';
 export type SDKMessage = CanonMessage;
 export type SDKConversation = CanonConversation;
 export interface ProgressMessageOptions extends SendMessageOptions {
@@ -59,8 +59,20 @@ export interface MessageHandlerContext {
     addMember: (userId: string) => Promise<void>;
     /** Remove a member from this conversation (requires owner/admin role) */
     removeMember: (userId: string) => Promise<void>;
+    /** Create a Canon work session rooted in this conversation. */
+    createWorkSession: (options?: Omit<CreateWorkSessionOptions, 'conversationId'>) => Promise<import('@canonmsg/core').CanonResolvedWorkSession>;
+    /** Load this conversation's scoped view of a Canon work session. */
+    getWorkSession: (workSessionId: string, conversationId?: string) => Promise<import('@canonmsg/core').CanonResolvedWorkSession>;
+    /** Update or attach this conversation's scoped work-session context. */
+    updateWorkSessionContext: (workSessionId: string, options?: UpdateWorkSessionConversationOptions) => Promise<import('@canonmsg/core').CanonResolvedWorkSession>;
+    /** Send into another conversation under an existing or lazily created Canon work session. */
+    sendLinkedMessage: (targetConversationId: string, text: string, options?: Omit<import('@canonmsg/core').SendLinkedMessageOptions, 'sourceConversationId' | 'targetConversationId' | 'text'>) => Promise<import('@canonmsg/core').SendLinkedMessageResult>;
     /** Trusted agent identity & access context */
     agent: import('@canonmsg/core').AgentContext;
+    /** Canon-provided shared task context for this turn, when attached to inbound messages. */
+    workSession?: import('@canonmsg/core').CanonWorkSessionContext | null;
+    /** All active Canon work sessions currently linked to this conversation. */
+    activeWorkSessions?: import('@canonmsg/core').CanonWorkSessionContext[];
     /** Per-conversation session state. Present when sessions are enabled. */
     session?: SessionInfo;
     /** Turn lifecycle helpers for live-work rendering and progress reporting. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@canonmsg/core": "^0.5.0"
+    "@canonmsg/core": "^0.6.0"
   },
   "publishConfig": {
     "access": "public"