English

The framework-neutral, Node-only development service shared by SpotPatch adapters. It owns validated options, session and source registries, authorized local HTTP handlers, bounded source context, editor launching, Runtime bootstrap configuration, and optional Agent orchestration.

Applications should install a framework adapter such as @spotpatch/vite. Browser code must never import this package, and provider credentials must remain in its trusted Node environment.

The service is development-only. Production adapters must omit it together with all private endpoints and source-registration state.

createDevelopmentSession owns the common AI, read-only Ask, external handoff and middleware lifecycle for Vite, Next and Astro. Frameworks inject bridge/validation/source-projection factories, retain their own transports, and call the idempotent close() on shutdown. Astro source imports remain subject to the same registry, path and read-budget authorization.

Requires Node.js >=20.19.0.

简体中文

这是 SpotPatch 框架适配器共享的框架无关、Node-only 开发服务，负责经过校验的选项、会话与源码注册、授权本地 HTTP Handler、有界源码上下文、编辑器启动、Runtime bootstrap 配置和可选 Agent 编排。

业务应用应安装 @spotpatch/vite 等框架适配器。浏览器代码绝不能导入本包，Provider 凭据也必须只保留在可信 Node 环境中。

本服务仅限开发期。生产适配器必须同时移除本包、全部私有端点和源码注册状态。

要求 Node.js >=20.19.0。

Links / 链接

• Repository / 仓库
• Security model / 安全模型
• MIT License / 许可证