feat(cohort)!: adopt unified capture foundations

.github/workflows/ci.yml

@@ -40,43 +40,11 @@ jobs:
       - name: Build
         run: pnpm build
 
-      - name: Verify packed package lifecycle
-        run: pnpm verify:package
-
-      - name: Verify packed package with Eval 0.183
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.183.0'
-
-      - name: Verify packed package with Eval 0.184
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.184.0'
-
-      - name: Verify packed package with Eval 0.185
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.185.0'
-
-      - name: Verify packed package with Eval 0.186
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.186.0'
-
-      - name: Verify packed package with Eval 0.187
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.187.0'
-
-      - name: Verify packed package with Eval 0.188
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.188.0'
-
-      - name: Verify packed package with Eval 0.189
-        run: pnpm verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.189.0'
+      - name: Verify packed package for every supported Eval minor
+        run: |
+          for version in $(node --input-type=module -e "import { evalCompatibilityVersions } from './scripts/lib/peer-range.mjs'; console.log(evalCompatibilityVersions.join(' '))"); do
+            AGENT_KNOWLEDGE_EVAL_VERSION="$version" pnpm run verify:package
+          done
 
   official-optimizers:
     runs-on: ubuntu-latest
@@ -98,40 +66,8 @@ jobs:
       - name: Install JavaScript dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Run packed package through official GEPA and SkillOpt
-        run: pnpm verify:official-optimizers
-
-      - name: Run official optimizers with Eval 0.183
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.183.0'
-
-      - name: Run official optimizers with Eval 0.184
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.184.0'
-
-      - name: Run official optimizers with Eval 0.185
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.185.0'
-
-      - name: Run official optimizers with Eval 0.186
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.186.0'
-
-      - name: Run official optimizers with Eval 0.187
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.187.0'
-
-      - name: Run official optimizers with Eval 0.188
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.188.0'
-
-      - name: Run official optimizers with Eval 0.189
-        run: pnpm verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.189.0'
+      - name: Run official GEPA and SkillOpt for every supported Eval minor
+        run: |
+          for version in $(node --input-type=module -e "import { evalCompatibilityVersions } from './scripts/lib/peer-range.mjs'; console.log(evalCompatibilityVersions.join(' '))"); do
+            AGENT_KNOWLEDGE_EVAL_VERSION="$version" pnpm run verify:official-optimizers
+          done

.github/workflows/publish.yml

@@ -39,81 +39,17 @@ jobs:
       - name: Build
         run: pnpm run build
 
-      - name: Verify packed package lifecycle
-        run: pnpm run verify:package
-
-      - name: Verify packed package with Eval 0.183
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.183.0'
-
-      - name: Verify packed package with Eval 0.184
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.184.0'
-
-      - name: Verify packed package with Eval 0.185
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.185.0'
-
-      - name: Verify packed package with Eval 0.186
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.186.0'
-
-      - name: Verify packed package with Eval 0.187
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.187.0'
-
-      - name: Verify packed package with Eval 0.188
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.188.0'
-
-      - name: Verify packed package with Eval 0.189
-        run: pnpm run verify:package
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.189.0'
-
-      - name: Run packed package through official GEPA and SkillOpt
-        run: pnpm run verify:official-optimizers
-
-      - name: Run official optimizers with Eval 0.183
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.183.0'
-
-      - name: Run official optimizers with Eval 0.184
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.184.0'
-
-      - name: Run official optimizers with Eval 0.185
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.185.0'
-
-      - name: Run official optimizers with Eval 0.186
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.186.0'
-
-      - name: Run official optimizers with Eval 0.187
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.187.0'
-
-      - name: Run official optimizers with Eval 0.188
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.188.0'
+      - name: Verify packed package for every supported Eval minor
+        run: |
+          for version in $(node --input-type=module -e "import { evalCompatibilityVersions } from './scripts/lib/peer-range.mjs'; console.log(evalCompatibilityVersions.join(' '))"); do
+            AGENT_KNOWLEDGE_EVAL_VERSION="$version" pnpm run verify:package
+          done
 
-      - name: Run official optimizers with Eval 0.189
-        run: pnpm run verify:official-optimizers
-        env:
-          AGENT_KNOWLEDGE_EVAL_VERSION: '0.189.0'
+      - name: Run official GEPA and SkillOpt for every supported Eval minor
+        run: |
+          for version in $(node --input-type=module -e "import { evalCompatibilityVersions } from './scripts/lib/peer-range.mjs'; console.log(evalCompatibilityVersions.join(' '))"); do
+            AGENT_KNOWLEDGE_EVAL_VERSION="$version" pnpm run verify:official-optimizers
+          done
 
       - name: Verify tag/version lock
         run: |

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 18.0.0 — 2026-09-29
+
+Require Eval 0.201 through 0.203, Interface 2.15, and TCloud 0.8.
+Require Node.js 22.12 to match TCloud's supported runtime.
+Use Zod 4.6.5 with the Core 0.10 and Trace Contract 2 dependency cohort.
+Knowledge 17 remains the release for older Eval contracts.
+Run packed-package and official optimizer checks against every supported Eval minor.
+Keep knowledge records, source formats, and public knowledge operations unchanged.
+
 ## 17.1.12 — 2026-09-28
 
 Allow consumers to install public Eval 0.200 alongside Knowledge after packed-package checks. Keep the previously supported Eval 0.182 through 0.199 releases; the 0.200.1 development pin replaces 0.199.0.

README.md

@@ -9,13 +9,16 @@ Supply application callbacks for those decisions, or use `@tangle-network/agent-
 ## Install
 
 ```bash
-pnpm add @tangle-network/agent-knowledge@17.1.4 @tangle-network/agent-eval@0.189.0 @tangle-network/agent-interface@2.10.0
+pnpm add @tangle-network/agent-knowledge@18.0.0 @tangle-network/agent-eval@0.203.0 @tangle-network/agent-interface@2.15.0
 ```
 
-Requires Node.js 20.19 or later.
+Requires Node.js 22.12 or later.
 
-Eval 0.182 through 0.189 are supported.
-Package and official optimizer checks exercise every released minor in that window; development remains pinned to 0.182.0.
+Eval 0.201 through 0.203 are supported.
+Package and official optimizer checks exercise each supported minor; development uses 0.203.0.
+These releases use Core 0.10, Trace Contract 2, and Zod 4.6.5.
+Knowledge 18 requires TCloud 0.8 with Sandbox 0.58.4 or later in that minor.
+Use Knowledge 17 with older Eval releases.
 
 ## Choose an API
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-knowledge",
-  "version": "17.1.12",
+  "version": "18.0.0",
   "description": "Build, search, evaluate, and improve source-backed knowledge bases.",
   "homepage": "https://github.com/tangle-network/agent-knowledge#readme",
   "repository": {
@@ -81,19 +81,19 @@
   "dependencies": {
     "@types/proper-lockfile": "4.1.4",
     "proper-lockfile": "4.1.2",
-    "zod": "4.5.4",
-    "@tangle-network/tcloud": ">=0.6.0 <0.7.0"
+    "zod": "4.6.5",
+    "@tangle-network/tcloud": ">=0.8.0 <0.9.0"
   },
   "peerDependencies": {
-    "@tangle-network/agent-eval": ">=0.182.0 <0.201.0",
-    "@tangle-network/agent-interface": "^2.13.0"
+    "@tangle-network/agent-eval": ">=0.201.0 <0.204.0",
+    "@tangle-network/agent-interface": "^2.15.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@biomejs/biome": "^2.5.14",
     "@neo4j-labs/agent-memory": "0.5.0",
-    "@tangle-network/agent-eval": "0.200.1",
-    "@tangle-network/agent-interface": "2.13.0",
+    "@tangle-network/agent-eval": "0.203.0",
+    "@tangle-network/agent-interface": "2.15.0",
     "@types/node": "^26.6.2",
     "mem0ai": "3.3.0",
     "oxc-parser": "0.151.0",
@@ -105,7 +105,7 @@
     "yaml": "2.9.1"
   },
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.12.0"
   },
   "license": "MIT",
   "packageManager": "pnpm@12.6.0"