@canonmsg/core 0.15.3 → 0.15.4

package/dist/reach-out.d.ts

@@ -1,4 +1,4 @@
-import type { CanonResolveAdmissionResult, CreateContactRequestResult, CreateConversationOptions, SendMessageOptions } from './types.js';
+import type { CanonResolveAdmissionResult, CreateContactRequestResult, CreateConversationOptions, SendMessageOptions, SessionConfig } from './types.js';
 export interface CanonReachOutClient {
     resolveAdmission(targetUserId: string): Promise<CanonResolveAdmissionResult>;
     createConversation(options: CreateConversationOptions): Promise<{
@@ -14,6 +14,7 @@ export interface CanonReachOutOptions {
     text?: string | null;
     requestMessage?: string | null;
     sendMessageOptions?: SendMessageOptions;
+    sessionConfig?: SessionConfig | null;
 }
 export type CanonReachOutResult = {
     status: 'messaged';
@@ -25,6 +26,9 @@ export type CanonReachOutResult = {
 } | {
     status: 'pending';
     requestId: string | null;
+} | {
+    status: 'setup_required';
+    reason: string;
 } | {
     status: 'blocked' | 'unavailable';
     reason: string;

package/dist/reach-out.js

@@ -11,6 +11,12 @@ function normalizeContactRequestMessage(requestMessage, fallbackText) {
         return text;
     return `${text.slice(0, CONTACT_REQUEST_MESSAGE_LIMIT - 3)}...`;
 }
+function optionsForResolvedTarget(options, targetUserType) {
+    if (options.sessionConfig && targetUserType === 'human') {
+        return { ...options, sessionConfig: null };
+    }
+    return options;
+}
 function isConnectionRequiredError(error) {
     const status = error && typeof error === 'object' && 'status' in error
         ? Number(error.status)
@@ -18,10 +24,34 @@ function isConnectionRequiredError(error) {
     const message = error instanceof Error ? error.message : String(error ?? '');
     return status === 403 && /CONNECTION_REQUIRED|connection required/i.test(message);
 }
+function isSessionSetupRequiredError(error) {
+    const status = error && typeof error === 'object' && 'status' in error
+        ? Number(error.status)
+        : null;
+    if (status !== 400 && status !== 403)
+        return null;
+    const rawMessage = error instanceof Error ? error.message : String(error ?? '');
+    const message = rawMessage.replace(/^Canon API error \d+:\s*/i, '').trim();
+    const parsed = (() => {
+        try {
+            const value = JSON.parse(message);
+            return typeof value.error === 'string' ? value.error : message;
+        }
+        catch {
+            return message;
+        }
+    })();
+    if (/session config|execution mode|coding session|worktree|workspace|permission mode|agent owner|runtime unavailable|unsupported control|invalid .*mode|invalid .*model/i
+        .test(parsed)) {
+        return parsed || 'Agent session setup is required.';
+    }
+    return null;
+}
 async function openConversationAndMaybeMessage(client, options) {
     const { conversationId } = await client.createConversation({
         type: 'direct',
         targetUserId: options.targetUserId,
+        ...(options.sessionConfig ? { sessionConfig: options.sessionConfig } : {}),
     });
     const text = normalizeOptionalText(options.text);
     if (text) {
@@ -35,7 +65,16 @@ async function openConversationAndMaybeMessage(client, options) {
 async function requestContact(client, options) {
     const result = await client.createContactRequest(options.targetUserId, normalizeContactRequestMessage(options.requestMessage, options.text));
     if (result.status === 'open') {
-        return openConversationAndMaybeMessage(client, { ...options, requestMessage: null });
+        try {
+            return await openConversationAndMaybeMessage(client, { ...options, requestMessage: null });
+        }
+        catch (error) {
+            const setupReason = isSessionSetupRequiredError(error);
+            if (setupReason) {
+                return { status: 'setup_required', reason: setupReason };
+            }
+            throw error;
+        }
     }
     if (result.status === 'duplicate') {
         return { status: 'pending', requestId: result.requestId };
@@ -48,14 +87,19 @@ async function requestContact(client, options) {
  * their product behavior is "message if reachable, otherwise request access."
  */
 export async function reachOutToCanonContact(client, options) {
-    const { admission } = await client.resolveAdmission(options.targetUserId);
+    const { target, admission } = await client.resolveAdmission(options.targetUserId);
+    const resolvedOptions = optionsForResolvedTarget(options, target?.userType);
     if (admission.state === 'allowed' && admission.canMessage) {
         try {
-            return await openConversationAndMaybeMessage(client, options);
+            return await openConversationAndMaybeMessage(client, resolvedOptions);
         }
         catch (error) {
+            const setupReason = isSessionSetupRequiredError(error);
+            if (setupReason) {
+                return { status: 'setup_required', reason: setupReason };
+            }
             if (isConnectionRequiredError(error)) {
-                return requestContact(client, options);
+                return requestContact(client, resolvedOptions);
             }
             throw error;
         }
@@ -64,7 +108,7 @@ export async function reachOutToCanonContact(client, options) {
         return { status: 'pending', requestId: admission.pendingRequestId ?? null };
     }
     if (admission.state === 'request-required' && admission.canRequestContact) {
-        return requestContact(client, options);
+        return requestContact(client, resolvedOptions);
     }
     if (admission.state === 'blocked') {
         return { status: 'blocked', reason: 'blocked' };

package/dist/types.d.ts

@@ -30,6 +30,7 @@ export interface ContactCardPayload {
     displayName: string;
     avatarUrl: string | null;
     userType: 'human' | 'ai_agent';
+    clientType?: AgentClientType;
     about?: string;
     isActive?: boolean;
     ownerId?: string;
@@ -461,6 +462,8 @@ export interface CreateConversationOptions {
     targetUserId?: string;
     memberIds?: string[];
     name?: string;
+    /** Required when creating a direct conversation with a first-party coding agent. */
+    sessionConfig?: SessionConfig | null;
 }
 export type StreamingStatus = 'thinking' | 'streaming' | 'tool';
 export interface SetStreamingOptions {

package/package.json

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