From bb1a0b7e688a54e02fae6e4305e605c9d311cdf0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <4062236+iscekic@users.noreply.github.com> Date: Tue, 20 Oct 2026 00:34:56 +0000 Subject: [PATCH 1/3] docs(mobile): record why jotai stays on 2.x --- apps/mobile/AGENTS.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/apps/mobile/AGENTS.md b/apps/mobile/AGENTS.md index ba019a7f6cf..315ae419adf 100644 --- a/apps/mobile/AGENTS.md +++ b/apps/mobile/AGENTS.md @@ -38,6 +38,16 @@ git diff --check - Install with `npx expo install ` (or `--dev`), never `pnpm add`. - After dependency changes, run `pnpx expo-doctor` and fix every issue. +- `jotai` stays on 2.x for now, and the four pins move together: `apps/mobile`, + `apps/web`, `apps/extension` and `packages/cloud-agent-sdk`. The SDK creates + the session atoms and this app reads them through its own jotai hooks, so a + mixed major fails `typecheck` at every shared atom: a 2.x `Atom` is not + assignable to the 3.x type because its `read` options still require `setSelf`, + which 3.x removed. `apps/web` cannot move first while + `jotai-minidb@0.0.8` (the latest release) imports `atomFamily` from + `jotai/vanilla/utils` and calls `setSelf`; both are gone in 3.x. Revisit when + `jotai-minidb` publishes a 3.x release; 3.0.1 already clears + `minimumReleaseAge`. - `@kilocode/kilo-chat-hooks` is copied, not symlinked. After editing it: ```bash From 1a14c4d3d5c9111cea25e3e5d976e3c64d5b7f0e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <4062236+iscekic@users.noreply.github.com> Date: Tue, 20 Oct 2026 00:38:17 +0000 Subject: [PATCH 2/3] docs(mobile): tighten the jotai dependency note --- apps/mobile/AGENTS.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/apps/mobile/AGENTS.md b/apps/mobile/AGENTS.md index 315ae419adf..a83b3a0973a 100644 --- a/apps/mobile/AGENTS.md +++ b/apps/mobile/AGENTS.md @@ -40,10 +40,10 @@ git diff --check - After dependency changes, run `pnpx expo-doctor` and fix every issue. - `jotai` stays on 2.x for now, and the four pins move together: `apps/mobile`, `apps/web`, `apps/extension` and `packages/cloud-agent-sdk`. The SDK creates - the session atoms and this app reads them through its own jotai hooks, so a - mixed major fails `typecheck` at every shared atom: a 2.x `Atom` is not - assignable to the 3.x type because its `read` options still require `setSelf`, - which 3.x removed. `apps/web` cannot move first while + the session atoms and each app reads them through its own jotai hooks, so a + partial bump fails `typecheck`: a 2.x `Atom` is not assignable to the 3.x + type because its `read` options still require `setSelf`, which 3.x removed + (mobile alone reports 153 such errors). `apps/web` cannot move first while `jotai-minidb@0.0.8` (the latest release) imports `atomFamily` from `jotai/vanilla/utils` and calls `setSelf`; both are gone in 3.x. Revisit when `jotai-minidb` publishes a 3.x release; 3.0.1 already clears From e8745e54d7f1769056f66cdd14d3b1d81def3fe4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20=C5=A0=C4=87eki=C4=87?= <4062236+iscekic@users.noreply.github.com> Date: Tue, 20 Oct 2026 00:39:22 +0000 Subject: [PATCH 3/3] docs(mobile): name a reachable jotai-minidb trigger --- apps/mobile/AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/mobile/AGENTS.md b/apps/mobile/AGENTS.md index a83b3a0973a..1d65d1c374c 100644 --- a/apps/mobile/AGENTS.md +++ b/apps/mobile/AGENTS.md @@ -45,9 +45,9 @@ git diff --check type because its `read` options still require `setSelf`, which 3.x removed (mobile alone reports 153 such errors). `apps/web` cannot move first while `jotai-minidb@0.0.8` (the latest release) imports `atomFamily` from - `jotai/vanilla/utils` and calls `setSelf`; both are gone in 3.x. Revisit when - `jotai-minidb` publishes a 3.x release; 3.0.1 already clears - `minimumReleaseAge`. + `jotai/vanilla/utils` and calls `setSelf`; both are gone in 3.x. Revisit as + soon as `jotai-minidb` ships a release that supports `jotai` 3; 3.0.1 already + clears `minimumReleaseAge`. - `@kilocode/kilo-chat-hooks` is copied, not symlinked. After editing it: ```bash