@canonmsg/codex-plugin 0.6.4 → 0.6.6

package/dist/host-runtime.d.ts

@@ -37,6 +37,12 @@ interface HostWorkspaceResolverOption {
     id: string;
     cwd: string;
 }
+export declare const HOST_ADMISSION_ACTION_CAPABILITIES: Readonly<{
+    canStartDirectConversation: false;
+    canSendContactRequest: false;
+    canApprovePendingContactRequests: false;
+    canRejectPendingContactRequests: false;
+}>;
 export declare function buildCanonHostPrompt(input: {
     hostLabel: string;
     content: string;
@@ -81,6 +87,21 @@ export declare function buildHydratedInboundContext(input: {
     hydratedFromPage: boolean;
 };
 export declare function publishHostAgentRuntime(agentId: string, clientType: AgentClientType, runtime: AgentRuntime): Promise<void>;
+export declare function publishHostSessionSnapshots(input: {
+    conversationIds: string[];
+    agentId: string;
+    clientType: AgentClientType;
+    runtime: AgentRuntime;
+    workspaceOptions: HostWorkspaceResolverOption[];
+    defaultCwd: string;
+    liveSessionConfigByConversation?: ReadonlyMap<string, {
+        model?: string;
+        permissionMode?: string;
+        workspaceId?: string;
+        executionMode?: SessionWorkspaceConfig['executionMode'];
+        executionBranch?: string | null;
+    }>;
+}): Promise<void>;
 export declare function readHostSessionConfig<TExtra extends string = never>(raw: unknown, extraStringFields?: readonly TExtra[]): (SessionWorkspaceConfig & Partial<Record<TExtra, string>>) | null;
 export declare function loadHostSessionConfig<TExtra extends string = never>(input: {
     conversationId: string;

package/dist/host-runtime.js

@@ -11,7 +11,13 @@
  * behavior here, update that copy too and adjust the shared golden
  * fixture test (`packages/codex-plugin/src/host-runtime.test.ts`).
  */
-import { buildBehaviorPolicyLines, buildParticipationHistorySnapshot, buildWorkSessionsPromptLines, mergeWorkSessionContexts, normalizeOptionalString, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, rtdbRead, rtdbWrite, } from '@canonmsg/core';
+import { buildAgentSessionSnapshot, buildConversationWorktreeSpec, buildBehaviorPolicyLines, buildParticipationHistorySnapshot, buildWorkSessionsPromptLines, mergeWorkSessionContexts, normalizeOptionalString, patchAgentSessionSnapshot, readSessionWorkspaceConfig, resolveConfiguredWorkspaceCwd, rtdbRead, rtdbWrite, } from '@canonmsg/core';
+export const HOST_ADMISSION_ACTION_CAPABILITIES = Object.freeze({
+    canStartDirectConversation: false,
+    canSendContactRequest: false,
+    canApprovePendingContactRequests: false,
+    canRejectPendingContactRequests: false,
+});
 export function buildCanonHostPrompt(input) {
     const resolvedWorkSessions = mergeWorkSessionContexts(input.workSession, input.workSessions);
     return [
@@ -69,7 +75,21 @@ function describeContactCard(card) {
     if (card.about)
         parts.push(`about: ${card.about}`);
     const identity = `📇 Contact card: "${card.displayName}" (${parts.join(' · ')}).`;
-    const hint = `This card is informational only in host mode. Canon does not currently expose a host-side tool here for starting a new direct conversation or sending a contact request to userId ${card.userId}.`;
+    const missingCapabilities = [
+        !HOST_ADMISSION_ACTION_CAPABILITIES.canStartDirectConversation
+            ? 'start a direct conversation'
+            : null,
+        !HOST_ADMISSION_ACTION_CAPABILITIES.canSendContactRequest
+            ? 'send a contact request'
+            : null,
+        !HOST_ADMISSION_ACTION_CAPABILITIES.canApprovePendingContactRequests
+            ? 'approve pending requests'
+            : null,
+        !HOST_ADMISSION_ACTION_CAPABILITIES.canRejectPendingContactRequests
+            ? 'reject pending requests'
+            : null,
+    ].filter(Boolean).join(', ');
+    const hint = `This host can inspect the card, but Canon admission actions are missing here. Missing capabilities: ${missingCapabilities}. Use another Canon surface for userId ${card.userId}.`;
     return `${identity}\n${hint}`;
 }
 function describeAttachment(attachment, materialized) {
@@ -116,6 +136,64 @@ export async function publishHostAgentRuntime(agentId, clientType, runtime) {
         updatedAt: { '.sv': 'timestamp' },
     });
 }
+export async function publishHostSessionSnapshots(input) {
+    if (input.conversationIds.length === 0) {
+        return;
+    }
+    await Promise.all(input.conversationIds.map(async (conversationId) => {
+        const persistedConfig = await loadHostSessionConfig({
+            conversationId,
+            agentId: input.agentId,
+            extraStringFields: ['permissionMode'],
+        });
+        const liveConfig = input.liveSessionConfigByConversation?.get(conversationId) ?? null;
+        const mergedConfig = {
+            ...(persistedConfig ?? {}),
+            ...(liveConfig ?? {}),
+        };
+        const snapshot = buildAgentSessionSnapshot({
+            conversationId,
+            agentId: input.agentId,
+            runtime: {
+                ...input.runtime,
+                clientType: input.clientType,
+                hostMode: true,
+            },
+            sessionConfig: {
+                ...(mergedConfig.model ? { model: mergedConfig.model } : {}),
+                ...(mergedConfig.permissionMode ? { permissionMode: mergedConfig.permissionMode } : {}),
+                ...(mergedConfig.workspaceId ? { workspaceId: mergedConfig.workspaceId } : {}),
+                ...(mergedConfig.executionMode ? { executionMode: mergedConfig.executionMode } : {}),
+            },
+            lastHeartbeatAt: undefined,
+        });
+        let executionBranch = liveConfig?.executionBranch ?? null;
+        if (!executionBranch && snapshot.executionMode === 'worktree' && snapshot.workspaceId) {
+            const workspace = input.workspaceOptions.find((option) => option.id === snapshot.workspaceId);
+            if (workspace) {
+                executionBranch = buildConversationWorktreeSpec({
+                    agentId: input.agentId,
+                    conversationId,
+                    workspaceCwd: workspace.cwd,
+                }).branch;
+            }
+        }
+        return patchAgentSessionSnapshot(conversationId, input.agentId, {
+            clientType: input.clientType,
+            hostMode: true,
+            model: snapshot.model ?? null,
+            permissionMode: snapshot.permissionMode ?? null,
+            workspaceId: snapshot.workspaceId ?? null,
+            executionMode: snapshot.executionMode ?? null,
+            executionBranch,
+            modelOptions: snapshot.modelOptions,
+            permissionModeOptions: snapshot.permissionModeOptions,
+            workspaceOptions: snapshot.workspaceOptions,
+            availableExecutionModes: snapshot.availableExecutionModes,
+            lastHeartbeatAt: { '.sv': 'timestamp' },
+        });
+    }));
+}
 export function readHostSessionConfig(raw, extraStringFields = []) {
     const baseConfig = readSessionWorkspaceConfig(raw);
     if (!raw || typeof raw !== 'object') {

package/dist/host.js

@@ -4,7 +4,7 @@ import { randomUUID } from 'node:crypto';
 import { parseArgs } from 'node:util';
 import { getCodexImagePath, materializeMessageMedia, } from '@canonmsg/agent-sdk';
 import { buildConfiguredWorkspaceOptions, buildPublicWorkspaceOptions, EXECUTION_ENVIRONMENT_MODES, ExecutionEnvironmentError, CanonClient, CanonStream, clearSessionState, clearTurnState, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, DEFAULT_RUNTIME_CAPABILITIES, FINAL_MESSAGE_HANDOFF_MS, getActiveProfile, initRTDBAuth, normalizeTurnMetadata, normalizeTurnState, prepareConversationEnvironment, releaseLock, releaseConversationEnvironment, resolveCanonAgent, rtdbRead, rtdbWrite, shouldTriggerAgentTurn, writeSessionState, writeTurnState, } from '@canonmsg/core';
-import { buildCanonHostPrompt, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, renderCanonHostInboundContent, resolveHostWorkspaceCwd, } from './host-runtime.js';
+import { buildCanonHostPrompt, buildHydratedInboundContext, createConversationMetadataLoader, loadHostSessionConfig, publishHostAgentRuntime, publishHostSessionSnapshots, renderCanonHostInboundContent, resolveHostWorkspaceCwd, } from './host-runtime.js';
 import { buildInboundContextLines, decideAutoReply, } from './inbound-policy.js';
 import { CodexConversationAdapter, } from './adapter.js';
 import { clearStoredThreadId, loadStoredThreadId, saveStoredThreadId, } from './session-store.js';
@@ -138,10 +138,27 @@ export async function main() {
     const sessions = new Map();
     const pendingSessionCreations = new Map();
     const conversationCache = new Map();
+    const knownConversationIds = new Set();
+    let lastKnownConversationRefreshAt = 0;
     const { getConversationMeta } = createConversationMetadataLoader({
         client,
         conversationCache,
     });
+    function resolveWorkspaceIdForBaseCwd(baseCwd) {
+        return workspaceOptions.find((option) => option.cwd === baseCwd)?.id;
+    }
+    async function refreshKnownConversationIds(force = false) {
+        if (!force && Date.now() - lastKnownConversationRefreshAt < HEARTBEAT_MS) {
+            return;
+        }
+        const conversations = await client.getConversations();
+        knownConversationIds.clear();
+        for (const conversation of conversations) {
+            knownConversationIds.add(conversation.id);
+            conversationCache.set(conversation.id, conversation);
+        }
+        lastKnownConversationRefreshAt = Date.now();
+    }
     async function loadSenderRuntimeState(conversationId, senderId) {
         try {
             const [turnState, sessionState] = await Promise.all([
@@ -236,6 +253,7 @@ export async function main() {
         }
     }
     async function getOrCreateSession(conversationId) {
+        knownConversationIds.add(conversationId);
         const existing = sessions.get(conversationId);
         if (existing && !existing.closed) {
             existing.lastActivity = Date.now();
@@ -335,6 +353,7 @@ export async function main() {
         void runNextTurn(session);
     }
     async function enqueueInboundMessage(input) {
+        knownConversationIds.add(input.conversationId);
         let materialized = [];
         if (input.message.id) {
             try {
@@ -555,9 +574,34 @@ export async function main() {
     const publishRuntimeHeartbeat = async () => {
         if (!streamConnected)
             return;
+        await refreshKnownConversationIds().catch((error) => {
+            console.error('[canon-codex] Failed to refresh known conversations:', error);
+        });
         await publishAgentRuntime(agentId, runtimeDescriptor).catch((error) => {
             console.error('[canon-codex] Failed to publish agent runtime:', error);
         });
+        await publishHostSessionSnapshots({
+            conversationIds: Array.from(knownConversationIds),
+            agentId,
+            clientType: 'codex',
+            runtime: runtimeDescriptor,
+            workspaceOptions,
+            defaultCwd: workingDir,
+            liveSessionConfigByConversation: new Map(Array.from(sessions.values()).map((session) => {
+                const workspaceId = resolveWorkspaceIdForBaseCwd(session.environment.baseCwd);
+                return [
+                    session.conversationId,
+                    {
+                        ...(session.state.model ? { model: session.state.model } : {}),
+                        ...(workspaceId ? { workspaceId } : {}),
+                        executionMode: session.environment.mode,
+                        executionBranch: session.environment.branch ?? null,
+                    },
+                ];
+            })),
+        }).catch((error) => {
+            console.error('[canon-codex] Failed to publish session snapshots:', error);
+        });
     };
     const stream = new CanonStream({
         apiKey,
@@ -614,7 +658,10 @@ export async function main() {
     }
     try {
         const conversations = await client.getConversations();
+        lastKnownConversationRefreshAt = Date.now();
         for (const conversation of conversations) {
+            knownConversationIds.add(conversation.id);
+            conversationCache.set(conversation.id, conversation);
             clearStreaming(conversation.id);
             clearSessionState(conversation.id, agentId).catch(() => { });
             clearTurnState(conversation.id, agentId).catch(() => { });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/codex-plugin",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Canon host integration for Codex CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -21,15 +21,16 @@
     "scripts"
   ],
   "scripts": {
-    "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
-    "dev": "tsc --watch",
+    "prepare:workspace-deps": "npm --prefix ../core run build && npm --prefix ../agent-sdk run build",
+    "build": "npm run prepare:workspace-deps && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
+    "dev": "npm run prepare:workspace-deps && tsc --watch",
     "smoke": "node scripts/smoke-test.mjs",
     "test": "vitest run",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@canonmsg/agent-sdk": "^0.8.2",
-    "@canonmsg/core": "^0.7.3"
+    "@canonmsg/agent-sdk": "^0.8.3",
+    "@canonmsg/core": "^0.7.5"
   },
   "engines": {
     "node": ">=18.0.0"