Skip to content

refactor!: remove deprecated APIs for 0.10 - #393

Merged
antfu merged 1 commit into
mainfrom
chore/remove-deprecated-apis-0.10
Sep 15, 2026
Merged

antfu merged 1 commit into
mainfrom
chore/remove-deprecated-apis-0.10

Conversation

@antfubot

Copy link
Copy Markdown
Collaborator

Prepares for the 0.10 release by dropping every symbol deprecated across the 0.9 line. Each removal has a drop-in replacement, all documented in a new Removed deprecated APIs section of the 0.10 migration guide.

What's removed

Removed Replacement
cli.mcp on a definition Pass mcp to the host (createCac / --mcp, createDevServer, initDevframe, initHub)
cli.distDir on a definition Top-level clientAssets
resolveClientAssets (from devframe) Read definition.clientAssets directly
hub createDevframeClientHost / DevframeClientHost / DevframeClientHostOptions createDevframeClientRuntime / DevframeClientRuntime / DevframeClientRuntimeOptions
coerceAgentPositionalArgs / AgentArgsFallback toolInputToRpcArgs / toolInputToCommandArgs
devframe/recipes/common-rpc-functions (openInEditor, openInFinder, commonRpcFunctions) @devframes/service-open
in-page-channel callEvent() alias emit()
a11y a11yPageScriptBundlePath / a11yAgentBundlePath a11yClientScriptBundlePath
data-inspector AGENT_DISCOVERY_FILE / AgentDiscovery / DataInspectorAgent DISCOVERY_FILE / InjectDiscovery / DataInspectorEndpoint

Notable consequences

  • Dropping cli.mcp retires the hub DF8005 warning and its diagnostic: the hub's aggregate MCP route already covers every mounted devframe, so a per-devframe MCP request no longer exists to conflict with the hub setting.
  • The recipe's still-live KnownEditor / KNOWN_EDITORS (consumed by @devframes/service-open) move to devframe/utils/launch-editor, their natural home.
  • All nine first-party plugins that set cli.distDir now set top-level clientAssets.
  • Net diff is strongly negative (~-400 lines); resolveClientAssets/resolveMcpConnectionMeta's now-dead fallback indirection is inlined or dropped.

All gates pass locally: pnpm lint && pnpm knip && pnpm test && pnpm typecheck && pnpm build. tsnapi API snapshots were regenerated (breaking changes are intentional for this major).

This PR was created with the help of an agent.

BREAKING CHANGE: drops every symbol deprecated across the 0.9 line ahead of
the 0.10 release, each with a drop-in replacement documented in the 0.10
migration guide:

- `cli.mcp` / `cli.distDir` on a definition — pass `mcp` to the host, and set
  top-level `clientAssets` instead. Removing `cli.mcp` also retires the hub
  DF8005 warning, since the aggregate route already covers every mounted
  devframe.
- `resolveClientAssets` (read `definition.clientAssets` directly).
- hub `createDevframeClientHost` / `DevframeClientHost[Options]` (use the
  `*ClientRuntime` names).
- `coerceAgentPositionalArgs` / `AgentArgsFallback`.
- the `devframe/recipes/common-rpc-functions` recipe (`openInEditor`,
  `openInFinder`) — use `@devframes/service-open`. Its non-deprecated
  `KnownEditor` / `KNOWN_EDITORS` move to `devframe/utils/launch-editor`.
- the in-page-channel `callEvent()` alias (use `emit()`).
- a11y `a11yPageScriptBundlePath` / `a11yAgentBundlePath`.
- data-inspector `AGENT_DISCOVERY_FILE` / `AgentDiscovery` / `DataInspectorAgent`.

Created with the help of an agent.
@coldtea-pr-lens

coldtea-pr-lens Bot commented Sep 15, 2026

Copy link
Copy Markdown

◈ PR Lens

🟢 +0 new · 🟠 ~19 changed · 🔴 -1 removed · 1 flow · 32 files · commit 37e3a34


Architecture

Architecture diagram for devframes/devframe at 37e3a34

20 components touched across 7 lanes.

Open the interactive canvas


Inside the changed components — 2 views

Component view — Devframe Core & Adapters

Core devframe instance shell, build and dev adapters, in-page channels, and wire services.

Architecture view of Component view — Devframe Core & Adapters in devframes/devframe

Component view — Hub & Framework Kits

Hub mounting, static build pipeline, framework adapters, and client runtimes.

Architecture view of Component view — Hub & Framework Kits in devframes/devframe

Data flow

Data flow diagram for devframes/devframe at 37e3a34

Mounting and serving devframe assets

Open the interactive canvas


View

  • Architecture lens
  • Data flow lens
  • Expand every detail

Tip

Run npx skills add coldteadotai/pr-lens, then tell your coding agent: "Diagram the change you just made with PR Lens and attach it to the pull request."

🪧 More tips
  • Run npx @coldtea/pr-lens-cli analyze --base origin/main on a branch, then npx @coldtea/pr-lens-cli render .pr-lens/graph.json. Same lenses, your own model key, before the pull request exists.
  • Untick Architecture lens or Data flow lens under View to hide a diagram, or tick Expand every detail to open every section. The comment redraws in a few seconds.
  • Click the link under each diagram to open it on a canvas you can zoom, pan and step through.
  • The diagrams are links. Click one to open it on the canvas, then press W or click play to walk through the change.
  • Open a diagram on the canvas, then press W or click play to walk through the change one step at a time.
  • The CLI's render reads .github/pr-lens.yml and applies your renames, exclusions and lane pins at draw time.
  • Set github.comment.collapsed: true in .github/pr-lens.yml to fold the comment behind one View architecture and data flow row. Drawing still runs on every push.
  • Add .github/workflows/pr-lens.yml with coldteadotai/pr-lens/packages/action@v0 and your model provider's key as its api-key to run PR Lens from your own CI. Any /chat/completions endpoint works.
  • Push a commit and the comment redraws for the new head. A slow older run never overwrites a newer one.
  • Switch GitHub to dark mode and the diagrams follow. The moving dots are this pull request's data in motion.

Thanks for using PR Lens! It's built by Coldtea, free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

@vercel

vercel Bot commented Sep 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
devframe Ready Ready Preview Sep 15, 2026 1:23am UTC

@antfu
antfu merged commit 4bf8fca into main Sep 15, 2026
13 of 14 checks passed
@antfu
antfu deleted the chore/remove-deprecated-apis-0.10 branch September 15, 2026 01:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants