@canonmsg/codex-plugin 0.12.0 → 0.13.0

package/dist/host.js

@@ -5,7 +5,7 @@ import { spawnSync } from 'node:child_process';
 import { dirname } from 'node:path';
 import { parseArgs } from 'node:util';
 import { getCodexImagePath, materializeMessageMedia, materializeReplyContextMedia, } from '@canonmsg/agent-sdk';
-import { RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildPlanApprovalRequest, buildCanonHostPrompt, buildConfiguredWorkspaceOptionsWithRoots, buildFirstPartyCodingRuntimeDescriptor, buildHydratedInboundContext, diffCanonMemberIds, buildPublicWorkspaceRoots, buildPublicWorkspaceOptions, buildRuntimePresentationPolicy, DEFAULT_FIRST_PARTY_RUNTIME_PRESENTATION, createConversationMetadataLoader, createRuntimeStatePublisher, EXECUTION_ENVIRONMENT_MODES, ExecutionEnvironmentError, CanonClient, CanonStream, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, DEFAULT_RUNTIME_CAPABILITIES, FINAL_MESSAGE_HANDOFF_MS, getActiveProfileLock, initRTDBAuth, buildLocalRuntimeId, heartbeatLocalRuntimeEntry, loadRuntimeSessionState, markLocalRuntimeStopped, normalizeTurnMetadata, prepareConversationEnvironment, loadHostSessionConfig, releaseConversationEnvironment, resolveCanonAgent, rtdbRead, rtdbWrite, shouldTriggerAgentTurn, saveRuntimeSessionState, buildBoundedTurnTrail, publishHostAgentRuntime, publishHostSessionSnapshots, renderCanonHostInboundContent, resolveHostWorkspaceCwd, upsertLocalRuntimeEntry, } from '@canonmsg/core';
+import { RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeCardOutcome, buildPlanApprovalRequest, buildCanonHostPrompt, buildConfiguredWorkspaceOptionsWithRoots, buildFirstPartyCodingRuntimeDescriptor, buildHydratedInboundContext, diffCanonMemberIds, buildPublicWorkspaceRoots, buildPublicWorkspaceOptions, buildRuntimePresentationPolicy, DEFAULT_FIRST_PARTY_RUNTIME_PRESENTATION, createConversationMetadataLoader, createRuntimeStatePublisher, EXECUTION_ENVIRONMENT_MODES, ExecutionEnvironmentError, CanonClient, CanonStream, DEFAULT_PARTICIPATION_HISTORY_FETCH_LIMIT, DEFAULT_RUNTIME_CAPABILITIES, FINAL_MESSAGE_HANDOFF_MS, getActiveProfileLock, initRTDBAuth, buildLocalRuntimeId, heartbeatLocalRuntimeEntry, loadRuntimeSessionState, markLocalRuntimeStopped, normalizeTurnMetadata, parseRuntimeCardV1, prepareConversationEnvironment, loadHostSessionConfig, releaseConversationEnvironment, resolveCanonAgent, rtdbRead, rtdbWrite, shouldTriggerAgentTurn, saveRuntimeSessionState, buildBoundedTurnTrail, publishHostAgentRuntime, publishHostSessionSnapshots, renderCanonHostInboundContent, resolveHostWorkspaceCwd, upsertLocalRuntimeEntry, } from '@canonmsg/core';
 import { buildInboundContextLines, decideAutoReply, } from './inbound-policy.js';
 import { CodexConversationAdapter, } from './adapter.js';
 import { CodexAppServerAdapter } from './app-server-adapter.js';
@@ -109,6 +109,21 @@ function buildCodexRuntimeDescriptor(input) {
         presentation: input.presentation,
         streamingTextMode: 'snapshot',
         commands,
+        ...(input.supportsRichCards
+            ? {
+                runtimeCards: {
+                    rich: {
+                        schema: 'canon.card.v1',
+                        lifecycle: 'blocking_requires_action',
+                        responder: 'agent_owner',
+                        result: 'action_or_values',
+                        maxTimeoutMs: 30 * 60_000,
+                        blockKinds: ['summary', 'metricGrid', 'chart', 'table', 'list', 'callout', 'actions'],
+                        native: true,
+                    },
+                },
+            }
+            : {}),
     });
     if (input.models.length > 0) {
         return descriptor;
@@ -893,10 +908,141 @@ export async function main() {
         }).catch(() => null);
         return { decision: 'deny' };
     }
+    async function waitForRuntimeCardResponse(input) {
+        while (Date.now() < input.expiresAt) {
+            const response = await client.consumeRuntimeCardResponse({
+                conversationId: input.conversationId,
+                cardId: input.cardId,
+            }).catch(() => null);
+            if (response?.status === 'submitted') {
+                return {
+                    status: 'submitted',
+                    ...(response.actionId ? { actionId: response.actionId } : {}),
+                    ...(response.values ? { values: response.values } : {}),
+                };
+            }
+            if (response?.status === 'cancelled' || response?.status === 'timeout') {
+                return { status: response.status };
+            }
+            await sleep(1_000);
+        }
+        const response = await client.consumeRuntimeCardResponse({
+            conversationId: input.conversationId,
+            cardId: input.cardId,
+        }).catch(() => null);
+        if (response?.status === 'submitted') {
+            return {
+                status: 'submitted',
+                ...(response.actionId ? { actionId: response.actionId } : {}),
+                ...(response.values ? { values: response.values } : {}),
+            };
+        }
+        return { status: 'timeout' };
+    }
+    function runtimeCardRequestPayload(method, params) {
+        if (method !== 'item/runtimeCard/request'
+            && method !== 'runtimeCard/request') {
+            return null;
+        }
+        const input = isRecord(params.input) ? params.input : null;
+        const args = isRecord(params.arguments) ? params.arguments : null;
+        return params.card ?? params.cardDocument ?? input?.card ?? args?.card ?? null;
+    }
     async function handleCodexServerRequest(session, request) {
         const requestId = String(request.id);
         const params = request.params;
         const expiresAt = Date.now() + 30 * 60_000;
+        const runtimeCardPayload = runtimeCardRequestPayload(request.method, params);
+        if (runtimeCardPayload) {
+            const card = parseRuntimeCardV1(runtimeCardPayload);
+            if (!card) {
+                return { status: 'cancelled', error: 'Invalid canon.card.v1 card' };
+            }
+            const cardId = readString(params, 'cardId')
+                ?? readString(params, 'itemId')
+                ?? card.cardId
+                ?? requestId;
+            let requestCreated = false;
+            let requestResolved = false;
+            try {
+                await client.createRuntimeCardRequest({
+                    conversationId: session.conversationId,
+                    cardId,
+                    card: { ...card, cardId },
+                    expiresAt,
+                    // Omit responseUserId so the backend targets a reachable member (the
+                    // owner if present, else the sole other member) — the owner is often
+                    // not a member of agent-to-user DMs.
+                    native: {
+                        runtime: 'codex',
+                        method: request.method,
+                        requestId,
+                        turnId: readString(params, 'turnId') ?? session.currentTurnId ?? undefined,
+                        handles: {
+                            itemId: readString(params, 'itemId') ?? '',
+                            threadId: readString(params, 'threadId') ?? '',
+                        },
+                    },
+                    turnId: session.currentTurnId ?? undefined,
+                });
+                requestCreated = true;
+                session.turnState = 'waiting_input';
+                markTurnProgress(session);
+                upsertTurnBlock(session, {
+                    id: `card:${cardId}`,
+                    kind: 'input',
+                    status: 'pending',
+                    title: card.title,
+                    summary: card.template ?? 'runtime card',
+                });
+                writeTurn(session);
+                stopVisibleWorkSignal(session);
+                writeCodexStreaming(session, null, 'waiting_input');
+                const response = await waitForRuntimeCardResponse({
+                    conversationId: session.conversationId,
+                    cardId,
+                    expiresAt,
+                });
+                requestResolved = true;
+                const outcome = buildRuntimeCardOutcome(cardId, response.status, { reason: response.status });
+                await client.sendMessage(session.conversationId, outcome.text, {
+                    metadata: {
+                        ...outcome.metadata,
+                        turnId: session.currentTurnId ?? undefined,
+                        turnSemantics: 'control',
+                        replyBehavior: 'suppress_auto_reply',
+                    },
+                });
+                completeTurnBlock(session, `card:${cardId}`, `Card ${response.status}`);
+                if (session.turnState === 'waiting_input') {
+                    session.turnState = 'thinking';
+                    markTurnProgress(session);
+                    writeTurn(session);
+                    startVisibleWorkSignal(session);
+                    writeCodexStreaming(session, null, 'thinking');
+                }
+                return response;
+            }
+            catch (error) {
+                if (requestCreated && !requestResolved) {
+                    await client.consumeRuntimeCardResponse({
+                        conversationId: session.conversationId,
+                        cardId,
+                        cancel: true,
+                    }).catch(() => null);
+                    const outcome = buildRuntimeCardOutcome(cardId, 'cancelled', { reason: 'interrupted' });
+                    await client.sendMessage(session.conversationId, outcome.text, {
+                        metadata: {
+                            ...outcome.metadata,
+                            turnId: session.currentTurnId ?? undefined,
+                            turnSemantics: 'control',
+                            replyBehavior: 'suppress_auto_reply',
+                        },
+                    }).catch(() => null);
+                }
+                throw error;
+            }
+        }
         if (request.method === 'item/tool/requestUserInput') {
             const paramsInput = isRecord(params.input) ? params.input : null;
             const paramsArguments = isRecord(params.arguments) ? params.arguments : null;
@@ -1347,6 +1493,7 @@ export async function main() {
             defaultPermissionMode: codexPermissionEnvelope.defaultPermissionMode,
             presentation: runtimePresentation,
             supportsPlanMode: useAppServer,
+            supportsRichCards: useAppServer,
         }),
     };
     async function baselineControlSignal(conversationId) {
@@ -1542,6 +1689,7 @@ export async function main() {
                 defaultPermissionMode: codexPermissionEnvelope.defaultPermissionMode,
                 presentation: runtimePresentation,
                 supportsPlanMode: useAppServer,
+                supportsRichCards: useAppServer,
             }),
         };
     }
@@ -1563,6 +1711,7 @@ export async function main() {
                 defaultPermissionMode: codexPermissionEnvelope.defaultPermissionMode,
                 presentation: runtimePresentation,
                 supportsPlanMode: useAppServer,
+                supportsRichCards: useAppServer,
             }),
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/codex-plugin",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Canon host integration for Codex CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@canonmsg/agent-sdk": "^2.0.0",
-    "@canonmsg/core": "^1.0.0"
+    "@canonmsg/agent-sdk": "^2.1.0",
+    "@canonmsg/core": "^1.2.0"
   },
   "engines": {
     "node": ">=18.0.0"