From 30850bbfc57e959766b8544b6c5a0a5fc7f88fc3 Mon Sep 17 00:00:00 2001
From: "Anthony Fu (via agent)" <reg-github-bot@antfu.me>
Date: Mon, 10 Aug 2026 01:42:40 +0000
Subject: [PATCH 1/2] chore!: remove deprecated 0.7-era compat shims for 0.9

Clears the compatibility shims deprecated across the 0.7 series and adds
the 0.9 migration guide.

- devframe/adapters/cli (createCli/CreateCliOptions/CliHandle) -> devframe/adapters/cac
- devframe/recipes/open-helpers (openHelpers) -> devframe/recipes/common-rpc-functions
- devframe/rpc dump re-exports -> devframe/rpc/dump
- @devframes/hub json-render shims (defineJsonRenderSpec, ctx.createJsonRenderer,
  DevframeViewJsonRender, JsonRenderSpec/JsonRenderElement/JsonRenderer)
  -> @devframes/json-render

Migrates the hub-ui reference viewer's json-render dock onto the serializable
view ref from @devframes/json-render/hub.
---
 alias.ts                                      |  2 -
 docs/.vitepress/config.ts                     |  1 +
 docs/adapters/cac.md                          |  2 -
 docs/guide/migration-0.9.md                   | 98 +++++++++++++++++++
 docs/helpers/common-rpc-functions.md          |  2 -
 knip.jsonc                                    |  4 +-
 packages/devframe/package.json                |  2 -
 packages/devframe/src/adapters/cac.ts         |  3 -
 packages/devframe/src/adapters/cli.ts         | 20 ----
 .../__tests__/common-rpc-functions.test.ts    |  5 -
 packages/devframe/src/recipes/open-helpers.ts | 12 ---
 .../src/rpc/dump/__tests__/dump.test.ts       |  3 +-
 packages/devframe/src/rpc/index.ts            | 50 ----------
 packages/devframe/tsdown.config.ts            |  2 -
 packages/hub-ui/package.json                  |  2 +
 .../components/views/ViewJsonRender.vue       | 18 ++--
 packages/hub-ui/src/client/types.ts           | 28 +-----
 packages/hub/src/define.ts                    | 12 ---
 .../hub/src/node/__tests__/context.test.ts    | 32 ------
 packages/hub/src/node/context.ts              | 53 +---------
 packages/hub/src/types/docks.ts               | 16 ---
 packages/hub/src/types/index.ts               |  3 -
 packages/hub/src/types/json-render.ts         | 40 --------
 pnpm-lock.yaml                                |  7 +-
 skills/devframe/SKILL.md                      |  4 +-
 .../tsnapi/@devframes/hub/index.snapshot.d.ts | 26 -----
 .../tsnapi/@devframes/hub/index.snapshot.js   |  1 -
 .../tsnapi/@devframes/hub/types.snapshot.d.ts |  4 -
 .../tsnapi/devframe/adapters/cac.snapshot.js  |  8 +-
 .../devframe/adapters/cli.snapshot.d.ts       | 21 ----
 .../tsnapi/devframe/adapters/cli.snapshot.js  | 12 ---
 .../recipes/open-helpers.snapshot.d.ts        | 37 -------
 .../devframe/recipes/open-helpers.snapshot.js |  9 --
 .../tsnapi/devframe/rpc.snapshot.d.ts         | 13 ---
 .../tsnapi/devframe/rpc.snapshot.js           | 15 ---
 .../tsnapi/devframe/rpc/dump.snapshot.d.ts    | 50 +++++++---
 .../utils/simple-schema.snapshot.d.ts         | 59 +++++++----
 tsconfig.base.json                            |  6 --
 38 files changed, 215 insertions(+), 467 deletions(-)
 create mode 100644 docs/guide/migration-0.9.md
 delete mode 100644 packages/devframe/src/adapters/cli.ts
 delete mode 100644 packages/devframe/src/recipes/open-helpers.ts
 delete mode 100644 packages/hub/src/types/json-render.ts
 delete mode 100644 tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.d.ts
 delete mode 100644 tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.js
 delete mode 100644 tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.d.ts
 delete mode 100644 tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.js

diff --git a/alias.ts b/alias.ts
index d80bc99c..c1deaabc 100644
--- a/alias.ts
+++ b/alias.ts
@@ -36,7 +36,6 @@ export const alias = {
   'devframe/utils/structured-clone': r('devframe/src/utils/structured-clone.ts'),
   'devframe/utils/when': r('devframe/src/utils/when.ts'),
   'devframe/adapters/cac': r('devframe/src/adapters/cac.ts'),
-  'devframe/adapters/cli': r('devframe/src/adapters/cli.ts'),
   'devframe/adapters/dev': r('devframe/src/adapters/dev.ts'),
   'devframe/adapters/build': r('devframe/src/adapters/build.ts'),
   'devframe/helpers/vite': r('devframe/src/helpers/vite.ts'),
@@ -80,7 +79,6 @@ export const alias = {
   '@devframes/plugin-git': p('git/src/index.ts'),
   'devframe/recipes/interactive-auth': r('devframe/src/recipes/interactive-auth.ts'),
   'devframe/recipes/common-rpc-functions': r('devframe/src/recipes/common-rpc-functions.ts'),
-  'devframe/recipes/open-helpers': r('devframe/src/recipes/open-helpers.ts'),
   'devframe/client': r('devframe/src/client/index.ts'),
   'devframe': r('devframe/src'),
   '@devframes/plugin-data-inspector/client': p('data-inspector/src/client/index.ts'),
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index aa06f91d..c85d140d 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -146,6 +146,7 @@ export function devframeNav(prefix = ''): DefaultTheme.NavItem[] {
         { text: 'Contributing', link: `${repo}/blob/main/CONTRIBUTING.md` },
         {
           items: [
+            { text: 'Migrating to 0.9', link: `${prefix}/guide/migration-0.9` },
             { text: 'Migrating to 0.7', link: `${prefix}/guide/migration-0.7` },
             { text: 'Migrating to 0.6', link: `${prefix}/guide/migration-0.6` },
           ],
diff --git a/docs/adapters/cac.md b/docs/adapters/cac.md
index ea4f0ed4..810f58ad 100644
--- a/docs/adapters/cac.md
+++ b/docs/adapters/cac.md
@@ -28,8 +28,6 @@ const devframe = defineDevframe({
 await createCac(devframe).parse()
 ```
 
-The `devframe/adapters/cli` entry (`createCli`) remains as a deprecated alias for this module — new code should import `createCac` from `devframe/adapters/cac`.
-
 Running the resulting binary:
 
 ```sh
diff --git a/docs/guide/migration-0.9.md b/docs/guide/migration-0.9.md
new file mode 100644
index 00000000..de70f882
--- /dev/null
+++ b/docs/guide/migration-0.9.md
@@ -0,0 +1,98 @@
+---
+outline: deep
+---
+
+# Migrating to 0.9
+
+0.9 removes the compatibility shims that were deprecated across the 0.7 series. Each removed export has a drop-in replacement that has shipped alongside it since 0.7, so migrating is a matter of updating import paths and a handful of call sites. This page covers the changes between 0.8.x and 0.9.
+
+## `devframe/adapters/cli` is removed
+
+The CLI adapter was renamed to `cac` in 0.7. The `devframe/adapters/cli` entry — `createCli`, `CreateCliOptions`, and `CliHandle` — is now gone. Import from `devframe/adapters/cac` instead:
+
+| 0.8.x | 0.9 |
+|-------|-----|
+| `import { createCli } from 'devframe/adapters/cli'` | `import { createCac } from 'devframe/adapters/cac'` |
+| `CreateCliOptions` | `CreateCacOptions` |
+| `CliHandle` | `CacHandle` |
+
+```ts
+// 0.8.x
+import { createCli } from 'devframe/adapters/cli'
+
+await createCli(devframe).parse()
+```
+
+```ts
+// 0.9
+import { createCac } from 'devframe/adapters/cac'
+
+await createCac(devframe).parse()
+```
+
+The typed-flag helpers `defineCliFlags` and `parseCliFlags` live on `devframe/adapters/cac` too. See [CLI (cac)](/adapters/cac) for the full adapter reference.
+
+## `devframe/recipes/open-helpers` is removed
+
+The recipe was renamed to `common-rpc-functions` in 0.7.16. Import `commonRpcFunctions` from `devframe/recipes/common-rpc-functions`:
+
+```ts
+// 0.8.x
+import { openHelpers } from 'devframe/recipes/open-helpers'
+```
+
+```ts
+// 0.9
+import { commonRpcFunctions } from 'devframe/recipes/common-rpc-functions'
+```
+
+The `openInEditor` and `openInFinder` members are unchanged. See [Common RPC functions](/helpers/common-rpc-functions) for the full reference.
+
+## RPC dump re-exports move to `devframe/rpc/dump`
+
+The static-dump helpers and types are served from the dedicated `devframe/rpc/dump` entry; the aliases that re-exported them from the top-level `devframe/rpc` barrel are removed. Import them from `devframe/rpc/dump`:
+
+```ts
+// 0.8.x
+import { createClientFromDump, dumpFunctions } from 'devframe/rpc'
+
+// 0.9
+import { createClientFromDump, dumpFunctions } from 'devframe/rpc/dump'
+```
+
+This applies to every dump export — `collectStaticRpcDump`, `createClientFromDump`, `dumpFunctions`, `getDefinitionsWithDumps`, `reviveDumpError`, `serializeDumpError`, and the `StaticRpcDump*` types.
+
+## `@devframes/hub` json-render shims are removed
+
+json-render moved out of the hub into the opt-in [`@devframes/json-render`](./json-render) integration in 0.7. The hub-local compatibility shims are now removed: the `defineJsonRenderSpec` helper, the `ctx.createJsonRenderer` factory, the `DevframeViewJsonRender` dock type, and the `JsonRenderSpec` / `JsonRenderElement` / `JsonRenderer` types.
+
+| 0.8.x (`@devframes/hub`) | 0.9 (`@devframes/json-render`) |
+|---|---|
+| `defineJsonRenderSpec(spec)` | Pass the spec directly to `createJsonRenderView(ctx, { id, spec })` |
+| `ctx.createJsonRenderer(spec)` | `createJsonRenderView(ctx, { id, spec })` (from `@devframes/json-render/node`) |
+| `JsonRenderSpec` | `DevframeJsonRenderSpec` |
+| `JsonRenderElement` | element shape of `DevframeJsonRenderSpec` |
+| `JsonRenderer` | `JsonRenderView` |
+| `DevframeViewJsonRender` | `DevframeJsonRenderDockEntry` (from `@devframes/json-render/hub`) |
+
+```ts
+// 0.8.x
+import { defineJsonRenderSpec } from '@devframes/hub'
+
+const spec = defineJsonRenderSpec({ root: 'panel', elements: { /* ... */ } })
+const renderer = ctx.createJsonRenderer(spec)
+```
+
+```ts
+// 0.9
+import { createJsonRenderView } from '@devframes/json-render/node'
+
+const view = createJsonRenderView(ctx, {
+  id: 'panel',
+  spec: { root: 'panel', elements: { /* ... */ } },
+})
+```
+
+`createJsonRenderView` returns a view carrying a serializable `ref` (a shared-state key or an inline spec). Project it onto a hub dock with `toJsonRenderDockEntry` from `@devframes/json-render/hub`, which contributes the `'json-render'` dock type to the hub's open dock union. A dock entry now carries that serializable `view` ref rather than a live renderer handle — a client reads `entry.view.stateKey` (or `entry.view.spec`) to render it.
+
+See [JSON-Render](./json-render) for the full integration reference.
diff --git a/docs/helpers/common-rpc-functions.md b/docs/helpers/common-rpc-functions.md
index 8efa0d43..f9ce70d4 100644
--- a/docs/helpers/common-rpc-functions.md
+++ b/docs/helpers/common-rpc-functions.md
@@ -30,8 +30,6 @@ defineDevframe({
 
 Both functions are `action`-type RPCs returning `void`, and their arguments are schema-validated — `openInEditor`'s `editor` argument is restricted to `KNOWN_EDITORS`, so a value outside that list fails validation rather than reaching the underlying `launch-editor` process spawn. Both handlers dynamically `import()` their underlying `devframe/utils/*` implementation, so the `launch-editor` and `open` dependencies only load when the recipe actually runs.
 
-The `devframe/recipes/open-helpers` entry (`openHelpers`) remains as a deprecated alias for this module — new code should import `commonRpcFunctions` from `devframe/recipes/common-rpc-functions`.
-
 ## Pick and choose
 
 Register only the helper you need rather than the whole array:
diff --git a/knip.jsonc b/knip.jsonc
index 38de700d..35ccf6be 100644
--- a/knip.jsonc
+++ b/knip.jsonc
@@ -73,12 +73,12 @@
       "entry": [
         "src/{index,constants}.ts",
         "src/helpers/vite.ts",
-        "src/adapters/{build,cac,cli,dev,embedded,initiate}.ts",
+        "src/adapters/{build,cac,dev,embedded,initiate}.ts",
         "src/adapters/mcp/index.ts",
         "src/client/index.ts",
         "src/node/index.ts",
         "src/node/{auth,hub-internals}/index.ts",
-        "src/recipes/{common-rpc-functions,interactive-auth,open-helpers}.ts",
+        "src/recipes/{common-rpc-functions,interactive-auth}.ts",
         "src/rpc/{index,client,server}.ts",
         "src/rpc/dump/index.ts",
         "src/rpc/transports/{ws-bun,ws-client,ws-server}.ts",
diff --git a/packages/devframe/package.json b/packages/devframe/package.json
index fec54b16..4f71c1ac 100644
--- a/packages/devframe/package.json
+++ b/packages/devframe/package.json
@@ -22,7 +22,6 @@
     ".": "./dist/index.mjs",
     "./adapters/build": "./dist/adapters/build.mjs",
     "./adapters/cac": "./dist/adapters/cac.mjs",
-    "./adapters/cli": "./dist/adapters/cli.mjs",
     "./adapters/dev": "./dist/adapters/dev.mjs",
     "./adapters/embedded": "./dist/adapters/embedded.mjs",
     "./adapters/mcp": "./dist/adapters/mcp.mjs",
@@ -35,7 +34,6 @@
     "./node/hub-internals": "./dist/node/hub-internals.mjs",
     "./recipes/common-rpc-functions": "./dist/recipes/common-rpc-functions.mjs",
     "./recipes/interactive-auth": "./dist/recipes/interactive-auth.mjs",
-    "./recipes/open-helpers": "./dist/recipes/open-helpers.mjs",
     "./rpc": "./dist/rpc/index.mjs",
     "./rpc/client": "./dist/rpc/client.mjs",
     "./rpc/dump": "./dist/rpc/dump.mjs",
diff --git a/packages/devframe/src/adapters/cac.ts b/packages/devframe/src/adapters/cac.ts
index a513e220..88556099 100644
--- a/packages/devframe/src/adapters/cac.ts
+++ b/packages/devframe/src/adapters/cac.ts
@@ -6,9 +6,6 @@
 // without it throws at load time with the usual Node module-not-found
 // error. The typed-flag helpers (`defineCliFlags` / `parseCliFlags`) are
 // re-exported below so they live alongside the CLI adapter.
-//
-// The historical `devframe/adapters/cli` entry (`createCli`) re-exports
-// this module under deprecated aliases for backward compatibility.
 import type { CAC } from 'cac'
 import type { H3 } from 'h3'
 import type { DevframeDefinition } from '../types/devframe'
diff --git a/packages/devframe/src/adapters/cli.ts b/packages/devframe/src/adapters/cli.ts
deleted file mode 100644
index bebadd05..00000000
--- a/packages/devframe/src/adapters/cli.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-// Deprecated compatibility shim for the cac adapter.
-//
-// Prefer the canonical `devframe/adapters/cac` entry (`createCac`). This
-// module re-exports the same implementation under the historical `cli`
-// names so existing imports keep working. It will be removed in a future
-// major release.
-import type { CacHandle, CreateCacOptions } from './cac'
-import { createCac } from './cac'
-
-export { defineCliFlags, parseCliFlags } from './flags'
-export type { CliFlagsSchema, InferCliFlags } from './flags'
-
-/** @deprecated Use `createCac` from `devframe/adapters/cac` instead. */
-export const createCli: typeof createCac = createCac
-
-/** @deprecated Use `CreateCacOptions` from `devframe/adapters/cac` instead. */
-export type CreateCliOptions = CreateCacOptions
-
-/** @deprecated Use `CacHandle` from `devframe/adapters/cac` instead. */
-export type CliHandle = CacHandle
diff --git a/packages/devframe/src/recipes/__tests__/common-rpc-functions.test.ts b/packages/devframe/src/recipes/__tests__/common-rpc-functions.test.ts
index 37b21f37..9057c434 100644
--- a/packages/devframe/src/recipes/__tests__/common-rpc-functions.test.ts
+++ b/packages/devframe/src/recipes/__tests__/common-rpc-functions.test.ts
@@ -1,7 +1,6 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec'
 import { describe, expect, it } from 'vitest'
 import { commonRpcFunctions, KNOWN_EDITORS, openInEditor, openInFinder } from '../common-rpc-functions'
-import { openHelpers } from '../open-helpers'
 
 /** Synchronously check whether a value satisfies a Standard Schema. */
 function accepts(schema: StandardSchemaV1, value: unknown): boolean {
@@ -42,8 +41,4 @@ describe('recipes/common-rpc-functions', () => {
     expect(commonRpcFunctions).toContain(openInEditor)
     expect(commonRpcFunctions).toContain(openInFinder)
   })
-
-  it('keeps the deprecated `devframe/recipes/open-helpers` entry working as an alias', () => {
-    expect(openHelpers).toBe(commonRpcFunctions)
-  })
 })
diff --git a/packages/devframe/src/recipes/open-helpers.ts b/packages/devframe/src/recipes/open-helpers.ts
deleted file mode 100644
index 85c18ed7..00000000
--- a/packages/devframe/src/recipes/open-helpers.ts
+++ /dev/null
@@ -1,12 +0,0 @@
-// Deprecated compatibility shim for the open helpers recipe.
-//
-// Prefer the canonical `devframe/recipes/common-rpc-functions` entry. This
-// module re-exports the same implementation under the historical name so
-// existing imports keep working. It will be removed in a future major
-// release.
-import { commonRpcFunctions } from './common-rpc-functions'
-
-export { openInEditor, openInFinder } from './common-rpc-functions'
-
-/** @deprecated Use `commonRpcFunctions` from `devframe/recipes/common-rpc-functions` instead. */
-export const openHelpers: typeof commonRpcFunctions = commonRpcFunctions
diff --git a/packages/devframe/src/rpc/dump/__tests__/dump.test.ts b/packages/devframe/src/rpc/dump/__tests__/dump.test.ts
index b203c360..7ba194c1 100644
--- a/packages/devframe/src/rpc/dump/__tests__/dump.test.ts
+++ b/packages/devframe/src/rpc/dump/__tests__/dump.test.ts
@@ -1,7 +1,8 @@
 import type { RpcDumpRecord } from '../../types'
 import * as v from 'valibot'
 import { describe, expect, it } from 'vitest'
-import { createClientFromDump, createDefineWrapperWithContext, defineRpcFunction, dumpFunctions } from '../..'
+import { createClientFromDump, dumpFunctions } from '..'
+import { createDefineWrapperWithContext, defineRpcFunction } from '../..'
 
 describe('dumps', () => {
   it('should collect dumps from definition', async () => {
diff --git a/packages/devframe/src/rpc/index.ts b/packages/devframe/src/rpc/index.ts
index 00448b0d..a96716ba 100644
--- a/packages/devframe/src/rpc/index.ts
+++ b/packages/devframe/src/rpc/index.ts
@@ -1,25 +1,3 @@
-import type {
-  StaticRpcDumpCollection as _StaticRpcDumpCollection,
-  StaticRpcDumpFile as _StaticRpcDumpFile,
-  StaticRpcDumpManifest as _StaticRpcDumpManifest,
-  StaticRpcDumpManifestQueryEntry as _StaticRpcDumpManifestQueryEntry,
-  StaticRpcDumpManifestStaticEntry as _StaticRpcDumpManifestStaticEntry,
-  StaticRpcDumpManifestValue as _StaticRpcDumpManifestValue,
-  StaticRpcDumpSerialization as _StaticRpcDumpSerialization,
-} from './dump/static'
-import {
-  createClientFromDump as _createClientFromDump,
-  dumpFunctions as _dumpFunctions,
-  getDefinitionsWithDumps as _getDefinitionsWithDumps,
-} from './dump'
-import {
-  reviveDumpError as _reviveDumpError,
-  serializeDumpError as _serializeDumpError,
-} from './dump/error'
-import {
-  collectStaticRpcDump as _collectStaticRpcDump,
-} from './dump/static'
-
 export * from './cache'
 export * from './collector'
 export * from './define'
@@ -28,31 +6,3 @@ export * from './serialization'
 export * from './types'
 export * from './validate-io'
 export * from './validation'
-
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const collectStaticRpcDump = _collectStaticRpcDump
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const createClientFromDump = _createClientFromDump
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const dumpFunctions = _dumpFunctions
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const getDefinitionsWithDumps = _getDefinitionsWithDumps
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const reviveDumpError = _reviveDumpError
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export const serializeDumpError = _serializeDumpError
-
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpCollection = _StaticRpcDumpCollection
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpFile = _StaticRpcDumpFile
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpManifest = _StaticRpcDumpManifest
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpManifestQueryEntry = _StaticRpcDumpManifestQueryEntry
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpManifestStaticEntry = _StaticRpcDumpManifestStaticEntry
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpManifestValue = _StaticRpcDumpManifestValue
-/** @deprecated Import from `devframe/rpc/dump` instead. */
-export type StaticRpcDumpSerialization = _StaticRpcDumpSerialization
diff --git a/packages/devframe/tsdown.config.ts b/packages/devframe/tsdown.config.ts
index e1c79dbe..1f35911f 100644
--- a/packages/devframe/tsdown.config.ts
+++ b/packages/devframe/tsdown.config.ts
@@ -103,7 +103,6 @@ const serverEntries = {
   'utils/open': 'src/utils/open.ts',
   'utils/serve-static': 'src/utils/serve-static.ts',
   'adapters/cac': 'src/adapters/cac.ts',
-  'adapters/cli': 'src/adapters/cli.ts',
   'adapters/dev': 'src/adapters/dev.ts',
   'adapters/build': 'src/adapters/build.ts',
   'adapters/embedded': 'src/adapters/embedded.ts',
@@ -112,7 +111,6 @@ const serverEntries = {
   'cli/main': 'src/cli/main.ts',
   'helpers/vite': 'src/helpers/vite.ts',
   'recipes/common-rpc-functions': 'src/recipes/common-rpc-functions.ts',
-  'recipes/open-helpers': 'src/recipes/open-helpers.ts',
   'recipes/interactive-auth': 'src/recipes/interactive-auth.ts',
 }
 
diff --git a/packages/hub-ui/package.json b/packages/hub-ui/package.json
index 3253f234..6ccd9f78 100644
--- a/packages/hub-ui/package.json
+++ b/packages/hub-ui/package.json
@@ -41,11 +41,13 @@
   },
   "peerDependencies": {
     "@devframes/hub": "workspace:*",
+    "@devframes/json-render": "workspace:*",
     "devframe": "workspace:*"
   },
   "devDependencies": {
     "@antfu/design": "catalog:frontend",
     "@devframes/hub": "workspace:*",
+    "@devframes/json-render": "workspace:*",
     "@iconify-json/ph": "catalog:frontend",
     "@json-render/core": "catalog:deps",
     "@json-render/vue": "catalog:frontend",
diff --git a/packages/hub-ui/src/client/components/views/ViewJsonRender.vue b/packages/hub-ui/src/client/components/views/ViewJsonRender.vue
index 47755a3f..39f83164 100644
--- a/packages/hub-ui/src/client/components/views/ViewJsonRender.vue
+++ b/packages/hub-ui/src/client/components/views/ViewJsonRender.vue
@@ -1,31 +1,35 @@
 <script setup lang="ts">
 import type { DocksContext } from '@devframes/hub/client'
+import type { DevframeJsonRenderDockEntry } from '@devframes/json-render/hub'
 import type { Spec } from '@json-render/core'
-import type { DevframeViewJsonRender } from '../../types'
 import { JSONUIProvider, Renderer } from '@json-render/vue'
 import { computed, markRaw, onMounted, ref, shallowRef, watch } from 'vue'
 import { devtoolsRegistry, UnsupportedComponent } from '../../json-render/registry'
 
 const props = defineProps<{
   context: DocksContext
-  entry: DevframeViewJsonRender
+  entry: DevframeJsonRenderDockEntry
 }>()
 
 const spec = shallowRef<Spec | null>(null)
 const isLoading = ref(true)
 const error = ref<string | null>(null)
 
-// Resolve spec from entry.ui._stateKey
+// Resolve the spec from the entry's serializable view ref: either a live
+// shared-state key the client subscribes to, or an inline spec rendered as-is.
 async function loadSpec() {
   try {
-    const stateKey = props.entry.ui?._stateKey
-    if (stateKey) {
-      const state = await props.context.rpc.sharedState.get(stateKey as any)
+    const view = props.entry.view
+    if ('stateKey' in view) {
+      const state = await props.context.rpc.sharedState.get(view.stateKey as any)
       spec.value = state.value() as unknown as Spec
       state.on('updated', (newValue) => {
         spec.value = newValue as unknown as Spec
       })
     }
+    else {
+      spec.value = view.spec as unknown as Spec
+    }
   }
   catch (e) {
     error.value = String(e)
@@ -83,7 +87,7 @@ const initialState = computed(() => {
 onMounted(loadSpec)
 
 // Re-load when entry changes
-watch(() => props.entry.ui?._stateKey, loadSpec)
+watch(() => props.entry.view, loadSpec)
 </script>
 
 <template>
diff --git a/packages/hub-ui/src/client/types.ts b/packages/hub-ui/src/client/types.ts
index 444b0a89..1fe4d601 100644
--- a/packages/hub-ui/src/client/types.ts
+++ b/packages/hub-ui/src/client/types.ts
@@ -1,4 +1,8 @@
-import type { DevframeDockEntryBase, DevframeDocksUserSettings, DevframeViewLauncher, JsonRenderer } from '@devframes/hub/types'
+import type { DevframeDocksUserSettings, DevframeViewLauncher } from '@devframes/hub/types'
+// Importing the hub-mounted json-render integration registers its
+// `'json-render'` dock entry (a serializable `view` ref, not a live handle)
+// on the hub's open dock union via declaration merging.
+import '@devframes/json-render/hub'
 
 /**
  * hub-ui user settings — the hub's {@link DevframeDocksUserSettings} widened
@@ -17,28 +21,6 @@ export interface HubDocksUserSettings extends DevframeDocksUserSettings {
   showDevframeInspector?: boolean
 }
 
-/**
- * A `json-render` dock entry. `@devframes/hub` ships no json-render variant of
- * its own (json-render is the opt-in `@devframes/json-render` package), so
- * hub-ui contributes this entry to the hub's open dock union.
- *
- * It carries the {@link JsonRenderer} handle from the deprecated
- * `ctx.createJsonRenderer()` on `ui`; the handle's methods are non-enumerable,
- * so only its serializable metadata survives dock projection into shared
- * state, where the client reads `ui._stateKey` to subscribe to the live spec.
- */
-export interface DevframeViewJsonRender extends DevframeDockEntryBase {
-  type: 'json-render'
-  /** The renderer handle created by `ctx.createJsonRenderer()`. */
-  ui: JsonRenderer
-}
-
-declare module '@devframes/hub/types' {
-  interface DevframeDockEntryRegistry {
-    'json-render': DevframeViewJsonRender
-  }
-}
-
 /**
  * A selectable launch root offered by a launcher dock entry.
  *
diff --git a/packages/hub/src/define.ts b/packages/hub/src/define.ts
index 2ab9d320..73c356f4 100644
--- a/packages/hub/src/define.ts
+++ b/packages/hub/src/define.ts
@@ -2,7 +2,6 @@ import type { WhenContext, WhenExpression } from 'devframe/utils/when'
 import type { DevframeHubContext } from './node/context'
 import type { DevframeServerCommandInput } from './types/commands'
 import type { DevframeDockUserEntry } from './types/docks'
-import type { JsonRenderSpec } from './types/json-render'
 import { createDefineWrapperWithContext } from 'devframe/rpc'
 
 export const defineHubRpcFunction = createDefineWrapperWithContext<DevframeHubContext>()
@@ -25,14 +24,3 @@ export function defineDockEntry<
 ): T {
   return entry as unknown as T
 }
-
-/**
- * @deprecated json-render moved out of the hub into the opt-in
- * `@devframes/json-render` integration in 0.7. This identity helper is kept
- * so existing imports keep compiling — pass your spec directly to
- * `createJsonRenderView` (from `@devframes/json-render/node`) instead.
- * Removed in 0.8.
- */
-export function defineJsonRenderSpec(spec: JsonRenderSpec): JsonRenderSpec {
-  return spec
-}
diff --git a/packages/hub/src/node/__tests__/context.test.ts b/packages/hub/src/node/__tests__/context.test.ts
index 37743225..919e24ad 100644
--- a/packages/hub/src/node/__tests__/context.test.ts
+++ b/packages/hub/src/node/__tests__/context.test.ts
@@ -59,38 +59,6 @@ describe('createHubContext dock activation', () => {
   })
 })
 
-describe('createHubContext createJsonRenderer (deprecated 0.7 compatibility factory)', () => {
-  it('seeds shared state with the initial spec and applies updateSpec/updateState', async () => {
-    const context = await createHubContext({
-      cwd: process.cwd(),
-      mode: 'build',
-      host: createHost(),
-    })
-
-    const renderer = context.createJsonRenderer({ root: 'panel', elements: {} })
-    const state = await context.rpc.sharedState.get<any>(renderer._stateKey)
-    expect(state.value()).toEqual({ root: 'panel', elements: {} })
-
-    await renderer.updateSpec({ root: 'panel', elements: {}, state: { count: 1 } })
-    expect(state.value()).toEqual({ root: 'panel', elements: {}, state: { count: 1 } })
-
-    await renderer.updateState({ count: 2, label: 'hi' })
-    expect(state.value()).toEqual({ root: 'panel', elements: {}, state: { count: 2, label: 'hi' } })
-  })
-
-  it('gives each renderer its own stable, distinct state key', async () => {
-    const context = await createHubContext({
-      cwd: process.cwd(),
-      mode: 'build',
-      host: createHost(),
-    })
-
-    const first = context.createJsonRenderer({ root: 'a', elements: {} })
-    const second = context.createJsonRenderer({ root: 'b', elements: {} })
-    expect(first._stateKey).not.toEqual(second._stateKey)
-  })
-})
-
 describe('startHttpAndWs remote endpoint metadata', () => {
   it('sets and clears the internal websocket endpoint', async () => {
     const context = await createHostContext({
diff --git a/packages/hub/src/node/context.ts b/packages/hub/src/node/context.ts
index dc8984fb..adf86802 100644
--- a/packages/hub/src/node/context.ts
+++ b/packages/hub/src/node/context.ts
@@ -2,7 +2,6 @@ import type { CreateHostContextOptions } from 'devframe/node'
 import type { DevframeHost, DevframeNodeContext } from 'devframe/types'
 import type { DevframeCommandsHost } from '../types/commands'
 import type { DevframeDockActivation, DevframeDocksActiveState, DevframeDocksHost } from '../types/docks'
-import type { JsonRenderer, JsonRenderSpec } from '../types/json-render'
 import type { DevframeMessageEntry, DevframeMessageEntryInput, DevframeMessagesHost } from '../types/messages'
 import type { DevframeTerminalsHost } from '../types/terminals'
 import { createHostContext } from 'devframe/node'
@@ -85,17 +84,15 @@ declare module 'devframe/types' {
 /**
  * Hub-augmented node context — extends devframe's framework-neutral
  * `DevframeNodeContext` with the hub-level subsystems (`docks`,
- * `terminals`, `messages`, `commands`) and the deprecated
- * `createJsonRenderer` compatibility factory.
+ * `terminals`, `messages`, `commands`).
  *
  * Framework kits further extend this with their own slots (e.g.
  * `viteConfig`, `viteServer`). Host-specific capabilities (editor open,
  * filesystem reveal, etc.) ship as kit-registered RPC functions rather
- * than as part of this surface. JSON-render itself is not part of the hub:
- * it is an opt-in integration (`@devframes/json-render`) that augments any
- * devframe context and contributes its own dock type — prefer
- * `createJsonRenderView` from `@devframes/json-render/node` over the
- * deprecated factory below.
+ * than as part of this surface. JSON-render is an opt-in integration
+ * (`@devframes/json-render`) that augments any devframe context and
+ * contributes its own dock type — use `createJsonRenderView` from
+ * `@devframes/json-render/node`.
  */
 export interface DevframeHubContext extends DevframeNodeContext {
   readonly host: DevframeHost
@@ -103,16 +100,6 @@ export interface DevframeHubContext extends DevframeNodeContext {
   terminals: DevframeTerminalsHost
   messages: DevframeMessagesHost
   commands: DevframeCommandsHost
-  /**
-   * Create a `JsonRenderer` handle for building json-render powered UIs.
-   *
-   * @deprecated json-render moved out of the hub into the opt-in
-   * `@devframes/json-render` integration in 0.7. This factory is kept
-   * working (not just type-compatible) for the 0.7 series so existing call
-   * sites don't break — use `createJsonRenderView(ctx, { id, spec })` from
-   * `@devframes/json-render/node` instead. Will be removed in 0.8.
-   */
-  createJsonRenderer: (spec: JsonRenderSpec) => JsonRenderer
 }
 
 /**
@@ -150,36 +137,6 @@ export async function createHubContext(options: CreateHubContextOptions): Promis
 
   await docks.init()
 
-  // Deprecated pre-0.7 compatibility factory — restored as a working (not
-  // merely type-compatible) shim so 0.7 only *deprecates* it rather than
-  // breaking it outright; see the `createJsonRenderer` JSDoc above. Kept
-  // self-contained against `context.rpc.sharedState` (as it was pre-0.7)
-  // rather than delegating to `@devframes/json-render`'s
-  // `createJsonRenderView`, so the hub still carries no dependency — direct
-  // or peer — on that opt-in package. Removed in 0.8: migrate call sites to
-  // `createJsonRenderView` before then.
-  let jsonRenderCounter = 0
-  context.createJsonRenderer = (initialSpec: JsonRenderSpec): JsonRenderer => {
-    const stateKey = `devframe:json-render:${jsonRenderCounter++}`
-    const statePromise = context.rpc.sharedState.get(stateKey as any, {
-      initialValue: initialSpec as any,
-    })
-
-    return {
-      _stateKey: stateKey,
-      async updateSpec(spec) {
-        const state = await statePromise
-        state.mutate(() => spec as any)
-      },
-      async updateState(newState) {
-        const state = await statePromise
-        state.mutate((draft: any) => {
-          draft.state = { ...draft.state, ...newState }
-        })
-      },
-    }
-  }
-
   const debounceMs = options.mode === 'build' ? 0 : 10
 
   const docksSharedState = await context.rpc.sharedState.get('devframe:docks', { initialValue: [] })
diff --git a/packages/hub/src/types/docks.ts b/packages/hub/src/types/docks.ts
index 795daf91..7551ae43 100644
--- a/packages/hub/src/types/docks.ts
+++ b/packages/hub/src/types/docks.ts
@@ -1,5 +1,4 @@
 import type { ConnectionMeta, EventEmitter } from 'devframe/types'
-import type { JsonRenderer } from './json-render'
 
 export interface DevframeDocksHost {
   readonly views: Map<string, DevframeDockUserEntry>
@@ -360,21 +359,6 @@ export interface DevframeViewBuiltin extends DevframeDockEntryBase {
   id: string
 }
 
-/**
- * @deprecated json-render moved out of the hub into the opt-in
- * `@devframes/json-render` integration in 0.7, which contributes its own
- * `'json-render'` entry (carrying a serializable view ref, not a live
- * `JsonRenderer` handle) to {@link DevframeDockEntryRegistry} via declaration
- * merging. This type is kept for compatibility but is no longer a member of
- * {@link DevframeDockUserEntry} — use `@devframes/json-render/hub` instead.
- * Removed in 0.8.
- */
-export interface DevframeViewJsonRender extends DevframeDockEntryBase {
-  type: 'json-render'
-  /** JsonRenderer handle created by the deprecated ctx.createJsonRenderer() */
-  ui: JsonRenderer
-}
-
 /**
  * A dock group: a single dock-bar button that collapses every entry whose
  * {@link DevframeDockEntryBase.groupId} matches this group's `id`.
diff --git a/packages/hub/src/types/index.ts b/packages/hub/src/types/index.ts
index 1645c388..e81a1c1a 100644
--- a/packages/hub/src/types/index.ts
+++ b/packages/hub/src/types/index.ts
@@ -4,9 +4,6 @@ export type { CreateHubContextOptions, DevframeHubContext } from '../node/contex
 
 export * from './commands'
 export * from './docks'
-// Deprecated pre-0.7 json-render types, kept for compatibility — see
-// `./json-render` for details on the `@devframes/json-render` replacement.
-export * from './json-render'
 export * from './messages'
 export * from './settings'
 export * from './terminals'
diff --git a/packages/hub/src/types/json-render.ts b/packages/hub/src/types/json-render.ts
deleted file mode 100644
index 5c583f30..00000000
--- a/packages/hub/src/types/json-render.ts
+++ /dev/null
@@ -1,40 +0,0 @@
-// Deprecated compatibility shim for the pre-0.7 hub-local json-render types.
-//
-// 0.7 moved json-render out of the hub into the opt-in `@devframes/json-render`
-// integration — use its `DevframeJsonRenderSpec` (from `@devframes/json-render`)
-// and `createJsonRenderView` (from `@devframes/json-render/node`) instead. These
-// types are kept so existing imports keep compiling through the 0.7 series;
-// they are removed in 0.8.
-
-/** @deprecated Use `DevframeJsonRenderSpec`'s element shape from `@devframes/json-render` instead. Removed in 0.8. */
-export interface JsonRenderElement {
-  type: string
-  props?: Record<string, unknown>
-  children?: string[]
-  /** json-render event bindings (e.g. `{ press: { action: "my:action" } }`) */
-  on?: Record<string, unknown>
-  /** json-render visibility condition */
-  visible?: unknown
-  /** json-render repeat binding */
-  repeat?: unknown
-  /** Allow additional json-render element fields */
-  [key: string]: unknown
-}
-
-/** @deprecated Use `DevframeJsonRenderSpec` from `@devframes/json-render` instead. Removed in 0.8. */
-export interface JsonRenderSpec {
-  root: string
-  elements: Record<string, JsonRenderElement>
-  /** Initial client-side state model for $state/$bindState expressions */
-  state?: Record<string, unknown>
-}
-
-/** @deprecated Use `JsonRenderView` from `@devframes/json-render` instead. Removed in 0.8. */
-export interface JsonRenderer {
-  /** Replace the entire spec */
-  updateSpec: (spec: JsonRenderSpec) => void | Promise<void>
-  /** Update json-render state values (shallow merge into spec.state) */
-  updateState: (state: Record<string, unknown>) => void | Promise<void>
-  /** Internal: shared state key used by the client to subscribe */
-  readonly _stateKey: string
-}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index bb725a00..7d879572 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -1106,6 +1106,9 @@ importers:
       '@devframes/hub':
         specifier: workspace:*
         version: link:../hub
+      '@devframes/json-render':
+        specifier: workspace:*
+        version: link:../json-render
       '@iconify-json/ph':
         specifier: catalog:frontend
         version: 1.2.2
@@ -11158,11 +11161,11 @@ snapshots:
 
   '@internationalized/date@3.12.2':
     dependencies:
-      '@swc/helpers': 0.5.15
+      '@swc/helpers': 0.5.23
 
   '@internationalized/number@3.6.7':
     dependencies:
-      '@swc/helpers': 0.5.15
+      '@swc/helpers': 0.5.23
 
   '@ioredis/commands@1.5.1': {}
 
diff --git a/skills/devframe/SKILL.md b/skills/devframe/SKILL.md
index a73a908f..7419bff4 100644
--- a/skills/devframe/SKILL.md
+++ b/skills/devframe/SKILL.md
@@ -247,7 +247,7 @@ A [scoped context](#scoped-context-preferred) applies this prefix for you — `c
 | `ctx.host` | Runtime abstraction — `mountStatic`, `resolveOrigin`, `getStorageDir` |
 | `ctx.mode` | `'dev'` or `'build'` — gate setup work per runtime |
 
-> Hosts can augment `ctx` with additional surfaces (e.g. Vite DevTools' `docks`, `terminals`, `messages`, `commands`, `createJsonRenderer`). Consult the host's docs — for Vite DevTools, see the [`vite-devtools-kit` skill](../../skills/vite-devtools-kit).
+> Hosts can augment `ctx` with additional surfaces (e.g. Vite DevTools' `docks`, `terminals`, `messages`, `commands`). Consult the host's docs — for Vite DevTools, see the [`vite-devtools-kit` skill](../../skills/vite-devtools-kit).
 
 ## RPC contracts
 
@@ -539,7 +539,7 @@ At runtime, static clients look up the argument hash in the dump; misses resolve
 | `spa` | Deployable SPA → `./dist-spa/` |
 | `mcp` | stdio MCP server (experimental) |
 
-**Bring your own CLI framework?** `createCac` (`devframe/adapters/cac`) is just a cac wrapper around three peer factories — `createDevServer` (`devframe/adapters/dev`), `createBuild` (`devframe/adapters/build`), and `createMcpServer` (`devframe/adapters/mcp`). Use them directly with commander/yargs/oclif when `createCac`'s baked-in command structure doesn't fit. `cac` is an optional peer dependency pulled in only through `devframe/adapters/cac`, so bring-your-own-CLI tools run without installing it. (The legacy `devframe/adapters/cli` entry / `createCli` remains as a deprecated alias.) `createDevServer` returns a `StartedServer` handle (`origin`, `port`, `app`, `wss`, `close()`) so you can wire SIGINT / hot-reload teardown into the surrounding program. `parseCliFlags(schema, raw)` and `defineCliFlags(...)` (both from `devframe/adapters/cac`) validate an arbitrary flag bag against a `CliFlagsSchema` — the helpers are framework-agnostic.
+**Bring your own CLI framework?** `createCac` (`devframe/adapters/cac`) is just a cac wrapper around three peer factories — `createDevServer` (`devframe/adapters/dev`), `createBuild` (`devframe/adapters/build`), and `createMcpServer` (`devframe/adapters/mcp`). Use them directly with commander/yargs/oclif when `createCac`'s baked-in command structure doesn't fit. `cac` is an optional peer dependency pulled in only through `devframe/adapters/cac`, so bring-your-own-CLI tools run without installing it. `createDevServer` returns a `StartedServer` handle (`origin`, `port`, `app`, `wss`, `close()`) so you can wire SIGINT / hot-reload teardown into the surrounding program. `parseCliFlags(schema, raw)` and `defineCliFlags(...)` (both from `devframe/adapters/cac`) validate an arbitrary flag bag against a `CliFlagsSchema` — the helpers are framework-agnostic.
 
 ## Bundled utilities
 
diff --git a/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.d.ts b/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.d.ts
index 8adf8273..9d94c09b 100644
--- a/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.d.ts
+++ b/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.d.ts
@@ -131,7 +131,6 @@ export interface DevframeHubContext extends DevframeNodeContext {
   terminals: DevframeTerminalsHost;
   messages: DevframeMessagesHost;
   commands: DevframeCommandsHost;
-  createJsonRenderer: (_: JsonRenderSpec) => JsonRenderer;
 }
 export interface DevframeMessageActivateAction {
   id: string;
@@ -291,10 +290,6 @@ export interface DevframeViewIframe extends DevframeDockEntryBase {
   subTabs?: FrameSubTabsConfig;
   remote?: boolean | RemoteDockOptions;
 }
-export interface DevframeViewJsonRender extends DevframeDockEntryBase {
-  type: 'json-render';
-  ui: JsonRenderer;
-}
 export interface DevframeViewLauncher extends DevframeDockEntryBase {
   type: 'launcher';
   launcher: {
@@ -315,25 +310,6 @@ export interface FrameSubTabsConfig {
   protocol: 'postmessage';
   handshakeTimeoutMs?: number;
 }
-export interface JsonRenderElement {
-  type: string;
-  props?: Record<string, unknown>;
-  children?: string[];
-  on?: Record<string, unknown>;
-  visible?: unknown;
-  repeat?: unknown;
-  [key: string]: unknown;
-}
-export interface JsonRenderer {
-  updateSpec: (_: JsonRenderSpec) => void | Promise<void>;
-  updateState: (_: Record<string, unknown>) => void | Promise<void>;
-  readonly _stateKey: string;
-}
-export interface JsonRenderSpec {
-  root: string;
-  elements: Record<string, JsonRenderElement>;
-  state?: Record<string, unknown>;
-}
 export interface NavTarget {
   path: string;
   query?: Record<string, string | readonly string[]>;
@@ -381,8 +357,6 @@ export declare function defineDockEntry<const T extends DevframeDockUserEntry, c
   when?: WhenExpression<WhenContext, W>;
   visibility?: WhenExpression<WhenContext, V>;
 }): T;
-/** @deprecated */
-export declare function defineJsonRenderSpec(_: JsonRenderSpec): JsonRenderSpec;
 // #endregion
 
 // #region Variables
diff --git a/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.js b/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.js
index 05f11f0f..bb672112 100644
--- a/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.js
+++ b/tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.js
@@ -4,7 +4,6 @@
 // #region Functions
 export function defineCommand(_) {}
 export function defineDockEntry(_) {}
-export function defineJsonRenderSpec(_) {}
 // #endregion
 
 // #region Variables
diff --git a/tests/__snapshots__/tsnapi/@devframes/hub/types.snapshot.d.ts b/tests/__snapshots__/tsnapi/@devframes/hub/types.snapshot.d.ts
index 099e839c..e22809a7 100644
--- a/tests/__snapshots__/tsnapi/@devframes/hub/types.snapshot.d.ts
+++ b/tests/__snapshots__/tsnapi/@devframes/hub/types.snapshot.d.ts
@@ -67,7 +67,6 @@ export { DevframeViewCustomRender }
 export { DevframeViewGroup }
 export { DevframeViewHost }
 export { DevframeViewIframe }
-export { DevframeViewJsonRender }
 export { DevframeViewLauncher }
 export { DevframeViewLauncherStatus }
 export { EntriesToObject }
@@ -75,9 +74,6 @@ export { EventEmitter }
 export { EventsMap }
 export { EventUnsubscribe }
 export { FrameSubTabsConfig }
-export { JsonRenderElement }
-export { JsonRenderer }
-export { JsonRenderSpec }
 export { NavTarget }
 export { PartialWithoutId }
 export { RemoteConnectionInfo }
diff --git a/tests/__snapshots__/tsnapi/devframe/adapters/cac.snapshot.js b/tests/__snapshots__/tsnapi/devframe/adapters/cac.snapshot.js
index 4d1f42c5..6520471e 100644
--- a/tests/__snapshots__/tsnapi/devframe/adapters/cac.snapshot.js
+++ b/tests/__snapshots__/tsnapi/devframe/adapters/cac.snapshot.js
@@ -1,8 +1,8 @@
 /**
  * Generated by tsnapi — public API snapshot of `devframe/adapters/cac`
  */
-// #region Other
-export { createCac }
-export { defineCliFlags }
-export { parseCliFlags }
+// #region Functions
+export function createCac(_, _) {}
+export function defineCliFlags(_) {}
+export function parseCliFlags(_, _) {}
 // #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.d.ts b/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.d.ts
deleted file mode 100644
index a521e6c4..00000000
--- a/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.d.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-/**
- * Generated by tsnapi — public API snapshot of `devframe/adapters/cli`
- */
-// #region Types
-/** @deprecated */
-export type CliHandle = CacHandle;
-/** @deprecated */
-export type CreateCliOptions = CreateCacOptions;
-// #endregion
-
-// #region Variables
-/** @deprecated */
-export declare const createCli: typeof createCac;
-// #endregion
-
-// #region Other
-export { CliFlagsSchema }
-export { defineCliFlags }
-export { InferCliFlags }
-export { parseCliFlags }
-// #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.js b/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.js
deleted file mode 100644
index 7b59f0ee..00000000
--- a/tests/__snapshots__/tsnapi/devframe/adapters/cli.snapshot.js
+++ /dev/null
@@ -1,12 +0,0 @@
-/**
- * Generated by tsnapi — public API snapshot of `devframe/adapters/cli`
- */
-// #region Variables
-/** @deprecated */
-export var createCli /* const */
-// #endregion
-
-// #region Other
-export { defineCliFlags }
-export { parseCliFlags }
-// #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.d.ts b/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.d.ts
deleted file mode 100644
index f798add0..00000000
--- a/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.d.ts
+++ /dev/null
@@ -1,37 +0,0 @@
-/**
- * Generated by tsnapi — public API snapshot of `devframe/recipes/open-helpers`
- */
-// #region Variables
-/** @deprecated */
-export declare const openHelpers: typeof commonRpcFunctions;
-export declare const openInEditor: {
-  name: "devframe:open-in-editor";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [SimpleSchema<string, string>, SimpleSchema<KnownEditor | undefined, KnownEditor | undefined>];
-  returns: SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: RpcFunctionAgentOptions;
-  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], Thenable<void>>>) | undefined;
-  handler?: ((args_0: string, args_1: KnownEditor | undefined) => Thenable<void>) | undefined;
-  dump?: RpcDump<[string, KnownEditor | undefined], Thenable<void>, undefined> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], Thenable<void>>>> | undefined;
-  __promise?: Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], Thenable<void>>> | undefined;
-};
-export declare const openInFinder: {
-  name: "devframe:open-in-finder";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [SimpleSchema<string, string>];
-  returns: SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: RpcFunctionAgentOptions;
-  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string], Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => Thenable<void>) | undefined;
-  dump?: RpcDump<[string], Thenable<void>, undefined> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string], Thenable<void>>>> | undefined;
-  __promise?: Thenable<RpcFunctionSetupResult<[string], Thenable<void>>> | undefined;
-};
-// #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.js b/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.js
deleted file mode 100644
index 98b63ad4..00000000
--- a/tests/__snapshots__/tsnapi/devframe/recipes/open-helpers.snapshot.js
+++ /dev/null
@@ -1,9 +0,0 @@
-/**
- * Generated by tsnapi — public API snapshot of `devframe/recipes/open-helpers`
- */
-// #region Variables
-/** @deprecated */
-export var openHelpers /* const */
-export var openInEditor /* const */
-export var openInFinder /* const */
-// #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.d.ts b/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.d.ts
index 0bd4e7ac..ac6befa9 100644
--- a/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.d.ts
+++ b/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.d.ts
@@ -4,16 +4,11 @@
 // #region Other
 export { BirpcFn }
 export { BirpcReturn }
-export { collectStaticRpcDump }
-export { createClientFromDump }
 export { createDefineWrapperWithContext }
 export { defineRpcFunction }
-export { dumpFunctions }
 export { EntriesToObject }
-export { getDefinitionsWithDumps }
 export { getRpcHandler }
 export { getRpcResolvedSetupResult }
-export { reviveDumpError }
 export { RpcArgsSchema }
 export { RpcCacheManager }
 export { RpcCacheOptions }
@@ -39,14 +34,6 @@ export { RpcFunctionsCollectorBase }
 export { RpcFunctionSetupResult }
 export { RpcFunctionType }
 export { RpcReturnSchema }
-export { serializeDumpError }
-export { StaticRpcDumpCollection }
-export { StaticRpcDumpFile }
-export { StaticRpcDumpManifest }
-export { StaticRpcDumpManifestQueryEntry }
-export { StaticRpcDumpManifestStaticEntry }
-export { StaticRpcDumpManifestValue }
-export { StaticRpcDumpSerialization }
 export { strictJsonStringify }
 export { STRUCTURED_CLONE_PREFIX }
 export { Thenable }
diff --git a/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.js b/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.js
index 6b1b818e..7c38cfa7 100644
--- a/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.js
+++ b/tests/__snapshots__/tsnapi/devframe/rpc.snapshot.js
@@ -31,21 +31,6 @@ export class RpcFunctionsCollectorBase {
 }
 // #endregion
 
-// #region Variables
-/** @deprecated */
-export var collectStaticRpcDump /* const */
-/** @deprecated */
-export var createClientFromDump /* const */
-/** @deprecated */
-export var dumpFunctions /* const */
-/** @deprecated */
-export var getDefinitionsWithDumps /* const */
-/** @deprecated */
-export var reviveDumpError /* const */
-/** @deprecated */
-export var serializeDumpError /* const */
-// #endregion
-
 // #region Other
 export { createDefineWrapperWithContext }
 export { defineRpcFunction }
diff --git a/tests/__snapshots__/tsnapi/devframe/rpc/dump.snapshot.d.ts b/tests/__snapshots__/tsnapi/devframe/rpc/dump.snapshot.d.ts
index 811447b3..a1914a83 100644
--- a/tests/__snapshots__/tsnapi/devframe/rpc/dump.snapshot.d.ts
+++ b/tests/__snapshots__/tsnapi/devframe/rpc/dump.snapshot.d.ts
@@ -1,18 +1,40 @@
 /**
  * Generated by tsnapi — public API snapshot of `devframe/rpc/dump`
  */
-// #region Other
-export { collectStaticRpcDump }
-export { createClientFromDump }
-export { dumpFunctions }
-export { getDefinitionsWithDumps }
-export { reviveDumpError }
-export { serializeDumpError }
-export { StaticRpcDumpCollection }
-export { StaticRpcDumpFile }
-export { StaticRpcDumpManifest }
-export { StaticRpcDumpManifestQueryEntry }
-export { StaticRpcDumpManifestStaticEntry }
-export { StaticRpcDumpManifestValue }
-export { StaticRpcDumpSerialization }
+// #region Interfaces
+export interface StaticRpcDumpCollection {
+  manifest: StaticRpcDumpManifest;
+  files: Record<string, StaticRpcDumpFile>;
+}
+export interface StaticRpcDumpFile {
+  serialization: StaticRpcDumpSerialization;
+  fnName: string;
+  data: unknown;
+}
+export interface StaticRpcDumpManifestQueryEntry {
+  type: 'query';
+  records: Record<string, string>;
+  fallback?: string;
+  serialization?: StaticRpcDumpSerialization;
+}
+export interface StaticRpcDumpManifestStaticEntry {
+  type: 'static';
+  path: string;
+  serialization?: StaticRpcDumpSerialization;
+}
+// #endregion
+
+// #region Types
+export type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
+export type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
+export type StaticRpcDumpSerialization = 'json' | 'structured-clone';
+// #endregion
+
+// #region Functions
+export declare function collectStaticRpcDump(_: Iterable<RpcFunctionDefinitionAny>, _: any): Promise<StaticRpcDumpCollection>;
+export declare function createClientFromDump<T extends Record<string, any>>(_: RpcDumpStore<T>, _?: RpcDumpClientOptions): BirpcReturn<T>;
+export declare function dumpFunctions<T extends readonly RpcFunctionDefinitionAny[]>(_: T, _?: any, _?: RpcDumpCollectionOptions): Promise<RpcDumpStore<RpcDefinitionsToFunctions<T>>>;
+export declare function getDefinitionsWithDumps<T extends readonly RpcFunctionDefinitionAny[]>(_: T): RpcFunctionDefinitionAny[];
+export declare function reviveDumpError(_: RpcDumpRecordError): Error;
+export declare function serializeDumpError(_: unknown): RpcDumpRecordError;
 // #endregion
\ No newline at end of file
diff --git a/tests/__snapshots__/tsnapi/devframe/utils/simple-schema.snapshot.d.ts b/tests/__snapshots__/tsnapi/devframe/utils/simple-schema.snapshot.d.ts
index 849c1046..375f41fb 100644
--- a/tests/__snapshots__/tsnapi/devframe/utils/simple-schema.snapshot.d.ts
+++ b/tests/__snapshots__/tsnapi/devframe/utils/simple-schema.snapshot.d.ts
@@ -1,21 +1,46 @@
 /**
  * Generated by tsnapi — public API snapshot of `devframe/utils/simple-schema`
  */
-// #region Other
-export { array }
-export { boolean }
-export { describe }
-export { literal }
-export { nullable }
-export { nullType }
-export { number }
-export { object }
-export { optional }
-export { picklist }
-export { record }
-export { s }
-export { SimpleSchema }
-export { string }
-export { union }
-export { voidType }
+// #region Interfaces
+export interface SimpleSchema<Input, Output = Input> extends StandardSchemaV1<Input, Output> {
+  readonly type: string;
+  readonly wrapped?: StandardSchemaV1;
+  readonly description?: string;
+}
+// #endregion
+
+// #region Functions
+export declare function array<T extends StandardSchemaV1>(_: T): SimpleSchema<StandardSchemaV1.InferInput<T>[], StandardSchemaV1.InferOutput<T>[]>;
+export declare function boolean(): SimpleSchema<boolean>;
+export declare function describe<T extends SimpleSchema<any, any>>(_: T, _: string): T;
+export declare function literal<const T extends string | number | boolean>(_: T): SimpleSchema<T>;
+export declare function nullable<T extends StandardSchemaV1>(_: T): SimpleSchema<StandardSchemaV1.InferInput<T> | null, StandardSchemaV1.InferOutput<T> | null>;
+export declare function nullType(): SimpleSchema<null>;
+export declare function number(): SimpleSchema<number>;
+export declare function object<T extends Record<string, StandardSchemaV1>>(_: T): SimpleSchema<InferObject<T, 'input'>, InferObject<T, 'output'>>;
+export declare function optional<T extends StandardSchemaV1>(_: T): SimpleSchema<StandardSchemaV1.InferInput<T> | undefined, StandardSchemaV1.InferOutput<T> | undefined>;
+export declare function picklist<const T extends readonly (string | number | boolean)[]>(_: T): SimpleSchema<T[number]>;
+export declare function record<V extends StandardSchemaV1>(_: StandardSchemaV1, _: V): SimpleSchema<Record<string, StandardSchemaV1.InferInput<V>>, Record<string, StandardSchemaV1.InferOutput<V>>>;
+export declare function string(): SimpleSchema<string>;
+export declare function union<const T extends readonly StandardSchemaV1[]>(_: T): SimpleSchema<StandardSchemaV1.InferInput<T[number]>, StandardSchemaV1.InferOutput<T[number]>>;
+export declare function voidType(): SimpleSchema<void>;
+// #endregion
+
+// #region Variables
+export declare const s: {
+  readonly string: typeof string;
+  readonly number: typeof number;
+  readonly boolean: typeof boolean;
+  readonly void: typeof voidType;
+  readonly null: typeof nullType;
+  readonly literal: typeof literal;
+  readonly picklist: typeof picklist;
+  readonly union: typeof union;
+  readonly record: typeof record;
+  readonly array: typeof array;
+  readonly object: typeof object;
+  readonly optional: typeof optional;
+  readonly nullable: typeof nullable;
+  readonly describe: typeof describe;
+};
 // #endregion
\ No newline at end of file
diff --git a/tsconfig.base.json b/tsconfig.base.json
index 9944e599..4303e6af 100644
--- a/tsconfig.base.json
+++ b/tsconfig.base.json
@@ -94,9 +94,6 @@
       "devframe/adapters/cac": [
         "./packages/devframe/src/adapters/cac.ts"
       ],
-      "devframe/adapters/cli": [
-        "./packages/devframe/src/adapters/cli.ts"
-      ],
       "devframe/adapters/dev": [
         "./packages/devframe/src/adapters/dev.ts"
       ],
@@ -226,9 +223,6 @@
       "devframe/recipes/common-rpc-functions": [
         "./packages/devframe/src/recipes/common-rpc-functions.ts"
       ],
-      "devframe/recipes/open-helpers": [
-        "./packages/devframe/src/recipes/open-helpers.ts"
-      ],
       "devframe/client": [
         "./packages/devframe/src/client/index.ts"
       ],

From 86103f3d7e87b26fb134501907668ce5df686566 Mon Sep 17 00:00:00 2001
From: "Anthony Fu (via agent)" <reg-github-bot@antfu.me>
Date: Mon, 10 Aug 2026 02:07:38 +0000
Subject: [PATCH 2/2] docs: add migration guide for 0.8

---
 docs/.vitepress/config.ts   |  1 +
 docs/guide/migration-0.8.md | 78 +++++++++++++++++++++++++++++++++++++
 2 files changed, 79 insertions(+)
 create mode 100644 docs/guide/migration-0.8.md

diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index c85d140d..2c37dd44 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -147,6 +147,7 @@ export function devframeNav(prefix = ''): DefaultTheme.NavItem[] {
         {
           items: [
             { text: 'Migrating to 0.9', link: `${prefix}/guide/migration-0.9` },
+            { text: 'Migrating to 0.8', link: `${prefix}/guide/migration-0.8` },
             { text: 'Migrating to 0.7', link: `${prefix}/guide/migration-0.7` },
             { text: 'Migrating to 0.6', link: `${prefix}/guide/migration-0.6` },
           ],
diff --git a/docs/guide/migration-0.8.md b/docs/guide/migration-0.8.md
new file mode 100644
index 00000000..dc1bb4ab
--- /dev/null
+++ b/docs/guide/migration-0.8.md
@@ -0,0 +1,78 @@
+---
+outline: deep
+---
+
+# Migrating to 0.8
+
+0.8 makes RPC schemas validator-neutral and validated at runtime, upgrades the MCP adapter to `@modelcontextprotocol/sdk` v2, and lands the agent-native MCP surface (`ctx.agent`, tool providers, and the `devframe connect` connector). This page covers the changes between 0.7.x and 0.8 — see the [v0.8.0 release notes](https://github.com/devframes/devframe/releases/tag/v0.8.0) for the full changelog.
+
+## RPC schemas are Standard Schema and validated at runtime
+
+`args` and `returns` on `defineRpcFunction` are now typed against [Standard Schema](https://standardschema.dev/) rather than valibot's `GenericSchema`. Any Standard-Schema-compliant validator works — valibot, zod, arktype — so existing valibot schemas keep compiling and inferring types unchanged.
+
+Two things change in practice:
+
+**Devframe no longer bundles a validator.** `valibot` was dropped from `devframe`'s runtime dependencies, so author your schemas with whichever validator you prefer and install it yourself:
+
+```sh
+npm install valibot # or: zod / arktype
+```
+
+If your app already pulls in zod (the JSON-render integration and the MCP server both use it), prefer zod for your RPC schemas and reuse the dependency. For first-party code that wants zero dependencies, devframe ships a minimal built-in builder at `devframe/utils/simple-schema`:
+
+```ts
+// Bring your own validator …
+import { defineRpcFunction } from 'devframe'
+import * as v from 'valibot'
+
+export const rename = defineRpcFunction({
+  name: 'devframes:plugin:terminals:rename',
+  type: 'action',
+  args: [v.object({ id: v.string(), title: v.string() })],
+  returns: v.void(),
+  setup: ctx => ({ handler: ({ id, title }) => { /* … */ } }),
+})
+```
+
+```ts
+// … or use the built-in zero-dep builder
+import { defineRpcFunction } from 'devframe'
+import { s } from 'devframe/utils/simple-schema'
+
+export const rename = defineRpcFunction({
+  name: 'devframes:plugin:terminals:rename',
+  type: 'action',
+  args: [s.object({ id: s.string(), title: s.string() })],
+  returns: s.void(),
+  setup: ctx => ({ handler: ({ id, title }) => { /* … */ } }),
+})
+```
+
+**Declared schemas are now enforced.** Each argument is validated against its schema at the boundary before the handler runs, and the resolved return value is validated on the way out; a mismatch is rejected with a coded diagnostic instead of reaching (or leaving) the handler. Payloads are guarded, not rewritten — extra object fields the schema doesn't mention still reach the handler. Audit any schema that was previously more of a type hint than a contract, since inputs that used to slip through now throw.
+
+See [RPC](./rpc) for the full reference.
+
+## MCP adapter upgraded to `@modelcontextprotocol/sdk` v2
+
+The MCP adapter now targets the v2 SDK, which ships as scoped `@modelcontextprotocol/server` and `@modelcontextprotocol/client` packages. Swap the peer dependency when you ship MCP support:
+
+| 0.7.x | 0.8 |
+|-------|-----|
+| `@modelcontextprotocol/sdk@^1` | `@modelcontextprotocol/server@^2` |
+
+```sh
+npm uninstall @modelcontextprotocol/sdk
+npm install @modelcontextprotocol/server
+```
+
+`@modelcontextprotocol/server` remains an optional peer dependency, pulled in only through `devframe/adapters/mcp`. The `devframe connect` connector (below) additionally uses `@modelcontextprotocol/client` — install it too if you drive agents through the connector.
+
+If you imported SDK types directly, the deep `@modelcontextprotocol/sdk/...` subpaths are now flat entries on the scoped packages (e.g. `@modelcontextprotocol/sdk/server/stdio.js` → `@modelcontextprotocol/server/stdio`). See [MCP](/adapters/mcp) for the adapter reference.
+
+## Agent-native MCP surface
+
+0.8 adds the agent host on `ctx.agent` — `registerTool`, `registerToolProvider`, and `registerResource` — plus an instance registry and the `devframe connect` MCP connector shipped in the `devframe` bin. These are additive; existing `agent`-flagged RPCs keep working and are projected to MCP as before.
+
+One type sharpens: an RPC `handler` (and its `dump`) now returns `Thenable<returns>` — the `returns` schema describes the *resolved* value and the runtime always awaits the handler. Synchronous handlers are unaffected; an `async` handler whose declared `returns` was the unwrapped value now type-checks correctly rather than needing the promise spelled into the schema.
+
+See [Agent-Native](./agent-native) for the tool/resource surface and [MCP → `devframe connect`](/adapters/mcp#discovery-devframe-connect) for the connector.