impel-cli 0.20.16 → 0.20.17

package/README.md

@@ -378,10 +378,14 @@ control-plane HTTP bearer credential, and fixes tenant selection in the
 transport header. Generated Claude/Codex MCP entries contain neither the PAT
 nor a tenant-derived credential.
 
-- The pinned Impel Claude Desktop can render the standard MCP Apps Tasks
-  resource when its host supports that protocol.
-- Claude Code and stable Codex receive complete headless task tools and text
-  results; no experimental Codex MCP Apps flag is enabled.
+- The pinned Impel Claude Desktop renders the standard MCP Apps task board when
+  its host supports that protocol.
+- The exact pinned Impel Codex desktop profile enables its reviewed
+  `enable_mcp_apps` contract so `show_tasks` can render the same board. The
+  vendor-pin test fails closed if the embedded Codex binary stops accepting it.
+- Claude Code and Codex CLI profiles remain headless and receive complete task
+  tools plus text results; the desktop-only renderer flag is never written to
+  those profiles.
 - Profiles preserve unrelated MCP servers. If a user-authored server already
   owns the `impel-tasks` name, setup/update fails with remediation instead of
   overwriting it.

package/RELEASE_NOTES.md

@@ -1,5 +1,14 @@
 # Release notes
 
+## 0.20.17 — Managed desktop task views
+
+- Enables the reviewed MCP Apps renderer only in exact managed Codex Desktop
+  profiles, while keeping Codex CLI profiles on their text and tool fallback.
+- Captures Claude permission, notification, and task lifecycle events through
+  the existing asynchronous, tenant-bound session hooks.
+- Preserves the additional lifecycle context needed to correlate task updates
+  without expanding the oversized-hook payload boundary.
+
 ## 0.20.16 — Correlated Codex transport timing
 
 - Derives native-agent MCP duration from correlated, timestamped Codex rollout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "impel-cli",
-  "version": "0.20.16",
+  "version": "0.20.17",
   "description": "Prepare isolated Claude and Codex workspaces for every accessible Impel tenant",
   "type": "module",
   "bin": {

package/src/apps.js

@@ -5,6 +5,7 @@ import crypto from "node:crypto";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import {
+  enableManagedCodexDesktopMcpApps,
   hardenManagedCodexToml,
   secureAllManagedCodexHomes,
   secureManagedCodexHome,
@@ -281,7 +282,9 @@ export function managedAppIdentity(target, tenantId = null, tenantName = null) {
 // expose direct-answer native agents through their one-shot local MCP binding.
 // 30: generate integrity-tracked top-level Codex profiles and direct code-mode
 // namespaces for fixed native-agent bindings.
-export const CURRENT_CONFIG_VERSION = 30;
+// 31: enable the reviewed MCP Apps renderer in pinned Codex Desktop profiles
+// and install Claude task, notification, and permission lifecycle hooks.
+export const CURRENT_CONFIG_VERSION = 31;
 
 // Identifies the bundle-BUILDING logic — the asar patches, plist rewrites,
 // helper rebranding, and signing. A vendored bundle is rebuilt only when this
@@ -1400,7 +1403,12 @@ function writeChatGPTConfig(
     CHATGPT_CONFIG_END,
   ].join("\n");
   const mergedToml = mergeManagedChatGPTToml(preservedToml, managedToml);
-  writeAtomic(configPath, hardenManagedCodexToml(mergedToml, configPath), 0o600);
+  const hardenedToml = hardenManagedCodexToml(mergedToml, configPath);
+  writeAtomic(
+    configPath,
+    enableManagedCodexDesktopMcpApps(hardenedToml, configPath),
+    0o600,
+  );
   secureManagedCodexHome(paths.chatgpt.codexHome);
 }
 

package/src/codexSecurity.js

@@ -148,6 +148,24 @@ export function hardenManagedCodexToml(toml, configPath = "managed Codex config"
   return applyManagedCodexSandboxPolicy(withoutCredentialSnapshots, configPath);
 }
 
+/**
+ * Enable the standard MCP Apps renderer only in the exact pinned desktop
+ * profile. CLI profiles deliberately stay headless, and vendor-pin contract
+ * tests must prove that the embedded Codex binary still recognizes this flag.
+ */
+export function enableManagedCodexDesktopMcpApps(
+  toml,
+  configPath = "managed Codex desktop config",
+) {
+  return upsertManagedScalar(
+    toml,
+    "features",
+    "enable_mcp_apps",
+    "true",
+    configPath,
+  );
+}
+
 function assertSafeManagedPath(target, expectedType) {
   const stat = lstatOrNull(target);
   if (!stat) return null;

package/src/sessionCollector.js

@@ -236,7 +236,8 @@ function compactLedgerPayload(input) {
   const keys = [
     "session_id", "hook_event_name", "cwd", "permission_mode", "model", "source", "reason",
     "turn_id", "prompt_id", "agent_id", "agent_type", "tool_name", "tool_use_id", "error",
-    "error_details", "last_assistant_message",
+    "error_details", "last_assistant_message", "notification_type", "message", "title",
+    "task_id", "task_subject", "task_description", "teammate_name", "tool_input",
   ];
   const payload = {};
   for (const key of keys) {

package/src/sessionHooks.js

@@ -12,10 +12,14 @@ const CODEX_TRUST_END = `# <<< ${RUNTIME_BRAND.product.id} managed session hook
 export const CLAUDE_SESSION_EVENTS = Object.freeze([
   "SessionStart",
   "UserPromptSubmit",
+  "PermissionRequest",
   "PostToolUse",
   "PostToolUseFailure",
+  "Notification",
   "SubagentStart",
   "SubagentStop",
+  "TaskCreated",
+  "TaskCompleted",
   "PreCompact",
   "PostCompact",
   "Stop",