diff --git a/changelog.md b/changelog.md
index a87cff1..fc21c85 100644
--- a/changelog.md
+++ b/changelog.md
@@ -4,6 +4,12 @@
 
 
 
+### Features
+
+- upgrade @push.rocks/smartai to ^4.0.0 (deps)
+  - Updates the core smartai dependency from ^2.3.0 to ^4.0.0.
+  - Refreshes README hints to document the new smartai version.
+
 ## 2026-05-14 - 3.2.0
 
 ### Features
diff --git a/package.json b/package.json
index adcf298..c7a96fe 100644
--- a/package.json
+++ b/package.json
@@ -37,7 +37,7 @@
     "@types/node": "^25.6.0"
   },
   "dependencies": {
-    "@push.rocks/smartai": "^2.3.0",
+    "@push.rocks/smartai": "^4.0.0",
     "@push.rocks/smartfs": "^1.5.1",
     "@push.rocks/smartrequest": "^5.0.1",
     "@push.rocks/smartshell": "^3.3.8",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 3dc1b71..4932633 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -9,8 +9,8 @@ importers:
   .:
     dependencies:
       '@push.rocks/smartai':
-        specifier: ^2.3.0
-        version: 2.3.0(typescript@6.0.3)(ws@8.20.0)(zod@4.4.1)
+        specifier: ^4.0.0
+        version: 4.0.0(typescript@6.0.3)(ws@8.20.0)(zod@4.4.1)
       '@push.rocks/smartfs':
         specifier: ^1.5.1
         version: 1.5.1
@@ -960,8 +960,8 @@ packages:
   '@push.rocks/qenv@6.1.3':
     resolution: {integrity: sha512-+z2hsAU/7CIgpYLFqvda8cn9rUBMHqLdQLjsFfRn5jPoD7dJ5rFlpkbhfM4Ws8mHMniwWaxGKo+q/YBhtzRBLg==}
 
-  '@push.rocks/smartai@2.3.0':
-    resolution: {integrity: sha512-i2Oz322qzU0ao/QJvpFNmqN8fkGbctImYZ6iDs9MYwR6KKbwoLDp1tZg1rM/nf1LuHOqjdojGcDNf0ycrTfHTw==}
+  '@push.rocks/smartai@4.0.0':
+    resolution: {integrity: sha512-wl6XZ6uQ/LQrz4fvKIan5zryKo/v+2uYwknXHsunyQ6rK0Nw8MPjQ4QFWLG+8wsaWvgh42WPKcCp6zWcVguvVw==}
 
   '@push.rocks/smartarchive@4.2.4':
     resolution: {integrity: sha512-uiqVAXPxmr8G5rv3uZvZFMOCt8l7cZC3nzvsy4YQqKf/VkPhKIEX+b7LkAeNlxPSYUiBQUkNRoawg9+5BaMcHg==}
@@ -4933,7 +4933,7 @@ snapshots:
       '@push.rocks/smartlog': 3.2.2
       '@push.rocks/smartpath': 6.0.0
 
-  '@push.rocks/smartai@2.3.0(typescript@6.0.3)(ws@8.20.0)(zod@4.4.1)':
+  '@push.rocks/smartai@4.0.0(typescript@6.0.3)(ws@8.20.0)(zod@4.4.1)':
     dependencies:
       '@ai-sdk/anthropic': 3.0.77(zod@4.4.1)
       '@ai-sdk/google': 3.0.73(zod@4.4.1)
diff --git a/readme.hints.md b/readme.hints.md
index cae5101..4f9d49c 100644
--- a/readme.hints.md
+++ b/readme.hints.md
@@ -24,7 +24,7 @@ Each exports a factory returning a flat `ToolSet` (Record<string, Tool>):
 4. **jsonTool()** → `json_validate`, `json_transform`
 
 ## Key Dependencies
-- `@push.rocks/smartai` ^2.0.0 — provider registry, `getModel()`, re-exports `tool`, `jsonSchema`
+- `@push.rocks/smartai` ^4.0.0 — provider registry, `getModel()`, re-exports `tool`, `jsonSchema`
 - `ai` ^6.0.0 — Vercel AI SDK v6 (`streamText`, `stepCountIs`, `ModelMessage`, `ToolSet`)
 - `zod` ^3.25.0 — tool input schema definitions
 - `@push.rocks/smartfs`, `smartshell`, `smartrequest` — tool implementations