@brunobracaioli/aibrain 0.4.0-beta.8 → 0.4.0-beta.9

package/README.md

@@ -58,7 +58,7 @@ notes or lock files to work around a reported storage error.
 
 The reviewed native compatibility set is Claude Code 2.1.294, 2.1.295, 2.1.296,
 2.1.299, 2.1.300, 2.1.301, 2.1.302 or 2.1.303, and Codex CLI 0.161.0,
-0.162.0, 0.162.1, 0.163.0 or 0.164.0. A newer stable Codex 0.x release may continue only
+0.162.0, 0.162.1, 0.163.0, 0.164.0 or 0.166.0 (0.165.0 was never qualified). A newer stable Codex 0.x release may continue only
 after its locally generated experimental protocol schemas and transport flags
 match the bundled adapter contract; prereleases, older releases and new majors
 remain rejected. Starting with beta14, newer stable Claude 2.1 patches can
@@ -74,6 +74,11 @@ record formats. Native launch/resume qualification is separate from a new
 model/JEV compaction qualification. A later native release that changes the
 consumed contract can still require an AI Brain compatibility update.
 
+`0.4.0-beta.9` refreshes the bundled contract to Codex 0.166.0. Its delta is
+additive: optional item timing, an image generation id, an attach-to-source fork
+flag and two error codes. See the
+[Codex 0.166 qualification record](../../docs/reference/codex-166-compatibility-2026-11-04.md).
+
 The Codex terminal bridge permits the native session picker's separate read-only
 connection while keeping the primary conversation and monitor intact. A picker
 cannot compact, start a turn, inject history or take ownership of the primary

package/dist/claude-observation.mjs

@@ -16,7 +16,7 @@ export const MAX_LOG_FILES = 3;
 const LOCK_WAIT_MS = 250;
 const LOCK_STALE_MS = 30_000;
 const ADMISSION_MS = 60 * 60 * 1000;
-export const ADAPTER_VERSION = '0.4.0-beta.8';
+export const ADAPTER_VERSION = '0.4.0-beta.9';
 const MAX_DIAGNOSTIC_COUNT = 10_000_000;
 const MAX_DIAGNOSTIC_BYTES = 128 * 1024 * 1024;
 const CHECKPOINT_BACKENDS = new Set(['native_store', 'private_file']);

package/dist/cli.mjs

@@ -40,7 +40,7 @@ import { extensionsSummary, hooksCommand, mcpCommand } from './extensions-cli.mj
 import { sessionServers } from './mcp-servers.mjs';
 import { anyFormatter } from './guardrails/format.mjs';
 
-const VERSION = '0.4.0-beta.8';
+const VERSION = '0.4.0-beta.9';
 // The command is `aisac`; `aibrain` is an alias installed from the same entry.
 const COMMAND = 'aisac';
 const ENDPOINT = 'https://mcp.ai-brain.aisac.cloud/mcp';

package/dist/codex-compatibility.mjs

@@ -26,7 +26,14 @@ const PAGINATION_CONTRACT_VALID =
       fingerprint.roots[PAGINATION_CONTRACT.response_schema]?.sha256 &&
     typeof PAGINATION_CONTRACT.graph_sha256 === 'string' &&
     PAGINATION_CONTRACT.graph_sha256.length === 64);
-const QUALIFIED_VERSIONS = new Set(['0.161.0', '0.162.0', '0.162.1', '0.163.0', '0.164.0']);
+const QUALIFIED_VERSIONS = new Set([
+  '0.161.0',
+  '0.162.0',
+  '0.162.1',
+  '0.163.0',
+  '0.164.0',
+  '0.166.0',
+]);
 const ANNOTATIONS = new Set([
   '$comment',
   'title',
@@ -475,7 +482,50 @@ export async function resolveCodexCompatibility(executable, baseEnvironment = pr
   }
 }
 
+/** @param {string} left @param {string} right */
+function compareStableVersions(left, right) {
+  const a = left.split('.').map(Number);
+  const b = right.split('.').map(Number);
+  for (let index = 0; index < 3; index += 1) {
+    const difference = (a[index] ?? 0) - (b[index] ?? 0);
+    if (difference !== 0) return difference;
+  }
+  return 0;
+}
+
+/** The newest Codex release this client was qualified against. */
+export const LATEST_QUALIFIED_CODEX = /** @type {string} */ (
+  [...QUALIFIED_VERSIONS].sort(compareStableVersions).at(-1)
+);
+
+// Rejections a user fixes by installing a qualified Codex (or a newer aisac):
+// the installed release's contract or transport differs from the bundled one.
+const CONTRACT_REJECTIONS = new Set([
+  'protocol_schema_mismatch',
+  'protocol_method_missing',
+  'schema_root_missing_or_invalid',
+  'schema_set_too_large',
+  'schema_generation_failed',
+  'transport_flags_missing',
+  'protocol_probe_failed',
+]);
+
+/** @param {{reason:string, version:string|null}} decision @returns {string|null} */
+export function codexCompatibilityRemedy(decision) {
+  const detected = decision.version === null ? 'The installed Codex' : `Codex ${decision.version}`;
+  const reinstall = `npm install -g @openai/codex@${LATEST_QUALIFIED_CODEX}`;
+  if (CONTRACT_REJECTIONS.has(decision.reason))
+    return `${detected} is not qualified by this aisac (newest qualified: ${LATEST_QUALIFIED_CODEX}). Install the qualified Codex with \`${reinstall}\`, or check for an aisac release that qualifies it with \`npm install -g @aisac/cli@beta\`.`;
+  if (decision.reason === 'version_unqualified')
+    return `${detected} is older than this aisac supports. Update it with \`${reinstall}\`.`;
+  if (decision.reason === 'version_not_stable_0x')
+    return `${detected} is not a stable 0.x release. Install a qualified one with \`${reinstall}\`.`;
+  return null;
+}
+
 /** @param {{reason:string, version:string|null}} decision @returns {string} */
 export function codexCompatibilityError(decision) {
-  return `codex_protocol_incompatible:${decision.reason}:detected=${decision.version ?? 'unavailable'};run aisac doctor --json`;
+  const coded = `codex_protocol_incompatible:${decision.reason}:detected=${decision.version ?? 'unavailable'};run aisac doctor --json`;
+  const remedy = codexCompatibilityRemedy(decision);
+  return remedy === null ? coded : `${coded}\n${remedy}`;
 }

package/dist/codex-protocol-fingerprint.json

@@ -1,13 +1,13 @@
 {
   "version": 3,
-  "native": "0.164.0",
+  "native": "0.166.0",
   "consumed_pagination": {
     "method": "thread/turns/list",
     "request_schema": "v2/ThreadTurnsListParams.json",
     "response_schema": "v2/ThreadTurnsListResponse.json",
     "request_schema_sha256": "29717980579b77eb4c7cbd1118dd238fcb3e010f3ef5236d74bd4e4f6e02c005",
-    "response_schema_sha256": "f46dddf14b7b6e8e484cb998a7d0b2efa3250167b9f2c366b83b22fe494c250f",
-    "graph_sha256": "20ba733654372954440b0cbee2964230934d064b9c2c3ee3c4ed850b08f7e370",
+    "response_schema_sha256": "53d96dae44edcecee02d8dcce5645800a52a62444f288ff48376e99e506561c6",
+    "graph_sha256": "a9008170cbf190054a75f4a539db7fe271e30cf85a157ad27e2dc2192785f311",
     "ordering": "asc",
     "items_view": "full"
   },
@@ -18,7 +18,7 @@
     },
     "v2/ThreadTurnsListResponse.json": {
       "methods": null,
-      "sha256": "f46dddf14b7b6e8e484cb998a7d0b2efa3250167b9f2c366b83b22fe494c250f"
+      "sha256": "53d96dae44edcecee02d8dcce5645800a52a62444f288ff48376e99e506561c6"
     },
     "ClientRequest.json": {
       "methods": [
@@ -39,7 +39,7 @@
         "config/read",
         "account/read"
       ],
-      "sha256": "415beba5414aeb1af34954de5c3d76c0f5a1c78f30f0a51cb291c471e920b365"
+      "sha256": "950bcefcb938bdf04b84305fdcf6767b05db782a0853ef1356fe05d607b0f5b3"
     },
     "ClientNotification.json": {
       "methods": ["initialized"],
@@ -78,7 +78,7 @@
         "thread/compacted",
         "warning"
       ],
-      "sha256": "590a474f19639e9c1b57238354c89ab0ef5f9d4022561ba2ed5f286cdf254181"
+      "sha256": "7f739a3a39a248692147f1a5b2212f440d36350bf2bcca0a5393abd32c188bdf"
     },
     "JSONRPCResponse.json": {
       "methods": null,
@@ -106,7 +106,7 @@
     },
     "v2/ThreadForkResponse.json": {
       "methods": null,
-      "sha256": "b1e26ab55f9fcbe108d325491d29678040d0776953093626fbcd9608593df31c"
+      "sha256": "36af2650a2f2fddd081dd6cb92a91632d0fc12e819fb47ceadcaf238990bec1e"
     },
     "v2/ThreadInjectItemsResponse.json": {
       "methods": null,
@@ -114,15 +114,15 @@
     },
     "v2/ThreadReadResponse.json": {
       "methods": null,
-      "sha256": "2de20539e09dd7110bd5b705f519288329bacc162d1c14c0c4af33ff27085e24"
+      "sha256": "136c873857d2ba0e1aa0836d96ec8d81bfc30a9209e058226e910e0179563e6b"
     },
     "v2/ThreadResumeResponse.json": {
       "methods": null,
-      "sha256": "bf6130a2dd9494a878e406f2d13535930ebc56f1a66cc1f597528537652a6a65"
+      "sha256": "ea37ce77b7a1b2fff78191dac117013ef817cfe1f0ab04f95d1bdc847ceacbb9"
     },
     "v2/ThreadStartResponse.json": {
       "methods": null,
-      "sha256": "b1e26ab55f9fcbe108d325491d29678040d0776953093626fbcd9608593df31c"
+      "sha256": "36af2650a2f2fddd081dd6cb92a91632d0fc12e819fb47ceadcaf238990bec1e"
     }
   },
   "requiredClientFlags": ["app-server", "--listen", "stdio://"],

package/dist/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@brunobracaioli/aibrain",
-  "version": "0.4.0-beta.8",
+  "version": "0.4.0-beta.9",
   "type": "module"
 }

package/dist/platform.mjs

@@ -86,7 +86,7 @@ export function isTestedNativeVersion(client, version) {
     return /^(?:(?:claude(?:\s+code)?)\s+)?2\.1\.(?:294|295|296|299|300|301|302|303)(?:\s+\(Claude\s+Code\))?$/iu.test(
       value,
     );
-  return /^(?:codex(?:-cli)?\s+)?0\.16(?:1\.0|2\.0|2\.1|3\.0|4\.0)$/iu.test(value);
+  return /^(?:codex(?:-cli)?\s+)?0\.16(?:1\.0|2\.0|2\.1|3\.0|4\.0|6\.0)$/iu.test(value);
 }
 
 const TESTED_NATIVE_VERSIONS = Object.freeze({
@@ -100,7 +100,7 @@ const TESTED_NATIVE_VERSIONS = Object.freeze({
     '2.1.302',
     '2.1.303',
   ]),
-  codex: Object.freeze(['0.161.0', '0.162.0', '0.162.1', '0.163.0', '0.164.0']),
+  codex: Object.freeze(['0.161.0', '0.162.0', '0.162.1', '0.163.0', '0.164.0', '0.166.0']),
 });
 
 /** @param {'claude'|'codex'} client @param {string} version */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunobracaioli/aibrain",
-  "version": "0.4.0-beta.8",
+  "version": "0.4.0-beta.9",
   "private": false,
   "description": "AISAC client for Claude Code and Codex: AI Brain memory, context management and AISAC Engineering",
   "license": "UNLICENSED",