impel-cli 0.20.18 → 0.20.20

package/RELEASE_NOTES.md

@@ -1,5 +1,24 @@
 # Release notes
 
+## 0.20.20 — Minimal Codex adapter tool surface
+
+- Disables Codex's stable multi-agent feature inside qualified managed adapter
+  profiles, removing collaboration tool schemas that fixed-binding children and
+  single-thread launches cannot legitimately use.
+- Advances the managed profile manifest so existing adapters refresh onto the
+  smaller, configuration-enforced tool surface immediately.
+
+## 0.20.19 — Recovered Codex stream accounting
+
+- Counts a zero-exit, completed Codex turn with a final agent message and one
+  native-agent start as successful even when the host reports transient stream
+  retry events before recovering.
+- Records recovered error-event counts separately in private attempt records
+  and aggregate analysis instead of silently discarding the successful sample.
+- Prevents generated Codex specialists from using collaboration messages to
+  report their terminal result, and refreshes already-fresh managed profiles
+  onto the tightened adapter instructions.
+
 ## 0.20.18 — Recoverable Codex profiling cohorts
 
 - Widens the bounded retry window for transient current-tenant reads while

package/package.json

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

package/scripts/analyze-native-codex.mjs

@@ -89,6 +89,7 @@ export function summarizeCodexEvents(events) {
   let outputTokens = 0;
   let turnCompleted = false;
   let errorEvents = 0;
+  let agentMessages = 0;
   let codeCells = 0;
   let codeWaits = 0;
 
@@ -102,6 +103,7 @@ export function summarizeCodexEvents(events) {
 
     const item = eventItem(event);
     const itemType = safeEventType(item.type);
+    if (type === "item.completed" && itemType === "agent_message") agentMessages += 1;
     const tool = eventTool(item);
     increment(toolCounts, tool);
     if (itemType && /(?:code_mode|command_execution|code_cell)/u.test(itemType)) codeCells += 1;
@@ -123,6 +125,7 @@ export function summarizeCodexEvents(events) {
     threadCount: threads.size,
     turnCompleted,
     errorEvents,
+    agentMessages,
     codeCells,
     codeWaits,
     inputTokens,
@@ -410,6 +413,8 @@ export function analyzeAggregates(aggregates) {
         timeout: attempts.filter((attempt) => attempt.timedOut).length,
         invalidJson: attempts.filter((attempt) => !attempt.jsonValid).length,
         descendantsRemaining: attempts.filter((attempt) => attempt.descendantsRemaining === true).length,
+        attemptsWithRecoveredErrors: successful.filter((attempt) => (attempt.errorEvents || 0) > 0).length,
+        recoveredErrorEvents: successful.reduce((total, attempt) => total + (attempt.errorEvents || 0), 0),
       },
     };
     report.gates = report.mode === "direct" ? directGate(report) : compatibleGate(report);

package/scripts/profile-native-codex.mjs

@@ -374,7 +374,7 @@ function parseArguments(argv) {
   return { ...options, help: false };
 }
 
-function safeAttemptRecord({ options, index, processResult, summary, jsonValid, parseError }) {
+export function safeAttemptRecord({ options, index, processResult, summary, jsonValid, parseError }) {
   const codex = summary?.codex || {};
   const telemetry = summary?.telemetry || {};
   const durationMs = processResult.endedAtMs - processResult.startedAtMs;
@@ -389,7 +389,7 @@ function safeAttemptRecord({ options, index, processResult, summary, jsonValid,
     && processResult.descendantsRemaining !== true
     && jsonValid
     && codex.turnCompleted === true
-    && (codex.errorEvents || 0) === 0
+    && (codex.agentMessages || 0) >= 1
     && (telemetry.localFailures || 0) === 0
     && startCalls === 1;
   return {
@@ -412,6 +412,8 @@ function safeAttemptRecord({ options, index, processResult, summary, jsonValid,
     parseFailureClass: parseError ? "invalid-jsonl" : null,
     success,
     eventCount: codex.eventCount || 0,
+    agentMessages: codex.agentMessages || 0,
+    errorEvents: codex.errorEvents || 0,
     threadCount: codex.threadCount || 0,
     toolCounts: codex.toolCounts || {},
     parentToolCounts: codex.parentToolCounts || {},

package/src/agents.js

@@ -52,7 +52,7 @@ export const NATIVE_AGENT_RUN_TOOL = "run_native_agent";
 export const NATIVE_AGENT_RESUME_TOOL = "resume_native_agent_run";
 export const NATIVE_AGENT_RECOVER_TOOL = "recover_native_agent_runs";
 export const MANAGED_AGENT_MCP_SERVER = "impel_agent";
-export const MANAGED_AGENT_MANIFEST_VERSION = 10;
+export const MANAGED_AGENT_MANIFEST_VERSION = 12;
 
 const NATIVE_AGENT_TOOL_NAMES = [
   NATIVE_AGENT_RUN_TOOL,
@@ -650,6 +650,7 @@ function codexAdapterInstructions(tenantId, agent) {
   const callerGuidance = usesVerbatimRelay(agent)
     ? adapterCallerSpawnGuidance("Codex")
     : null;
+  const collaborationConstraint = `Collaboration tools are disabled. Return one final response to the caller after the native-agent transport reaches terminal.`;
   if (usesDirectAnswer(agent)) {
     const completionGuidance = usesVerbatimRelay(agent)
       ? adapterAnswerVerbatimCompletionGuidance()
@@ -657,6 +658,7 @@ function codexAdapterInstructions(tenantId, agent) {
     return [
       `You are a thin transport adapter for the exact Impel native agent ${JSON.stringify(agent.agentId)} in tenant ${JSON.stringify(tenantId)}.`,
       ...(callerGuidance ? [callerGuidance] : []),
+      collaborationConstraint,
       `Do not perform the assigned task yourself, do not delegate to any other agent, and do not independently synthesize the result.`,
       `Confirm that the assigned request fits the cataloged capabilities ${JSON.stringify(agent.capabilities)} and none of the exclusions ${JSON.stringify(agent.exclusions)} before answering.${contextRequirement}`,
       sideEffectInstruction,
@@ -671,6 +673,7 @@ function codexAdapterInstructions(tenantId, agent) {
   return [
     `You are a thin transport adapter for the exact Impel native agent ${JSON.stringify(agent.agentId)} in tenant ${JSON.stringify(tenantId)}.`,
     ...(callerGuidance ? [callerGuidance] : []),
+    collaborationConstraint,
     `Do not perform the assigned task yourself, do not delegate to any other agent, and do not independently synthesize or rewrite the result.`,
     `Confirm that the assigned request fits the cataloged capabilities ${JSON.stringify(agent.capabilities)} and none of the exclusions ${JSON.stringify(agent.exclusions)} before starting.${contextRequirement}`,
     sideEffectInstruction,
@@ -683,6 +686,7 @@ function codexAdapterInstructions(tenantId, agent) {
 function retiredAdapterInstructions(tenantId, agent) {
   return [
     `You are a recovery-only transport adapter for retired Impel native-agent binding ${JSON.stringify(agent.agentId)} in tenant ${JSON.stringify(tenantId)}.`,
+    `Collaboration tools are disabled. Return one final response to the caller after the native-agent transport reaches terminal.`,
     `You cannot start new work. Never call run_native_agent and never perform or recreate the assigned task yourself.`,
     `Call ${nativeToolName(NATIVE_AGENT_RECOVER_TOOL)} with {} to obtain integrity-validated pending handles for this fixed binding, then call ${nativeToolName(NATIVE_AGENT_RESUME_TOOL)} with the intended handle until it returns a terminal result. If multiple handles cannot be safely associated with the request, report them instead of choosing.`,
     `Return successful finalText byte-for-byte. For failure, return the preserved runId, output, and error without inventing a replacement result.`,
@@ -772,6 +776,9 @@ function renderCodexConfiguration({
     `developer_instructions = ${JSON.stringify(recoveryOnly ? retiredAdapterInstructions(tenantId, agent) : codexAdapterInstructions(tenantId, agent))}`,
     "",
     ...(directCodeMode ? [
+      "[features]",
+      "multi_agent = false",
+      "",
       "[features.code_mode]",
       "enabled = true",
       `direct_only_tool_namespaces = [${JSON.stringify(nativeToolNamespace())}]`,