@steerable/pack-sdk 0.6.52 → 0.6.55

package/README.md

@@ -3,8 +3,7 @@
 Scenario pack contract for `@steerable/agent-shell` — pure types, zero runtime.
 
 A scenario pack declares every extension a vertical scenario needs (services,
-tools, tables, skills, agent seeds, IPC, HTTP routes, preload bridge, renderer
-slots, branding), and the host composes the selected packs at build time. This
+tools, tables, skills, agent seeds, HTTP routes, renderer slots, branding), and the host composes the selected packs at build time. This
 package ships only `types/`; there is no runtime code.
 
 License: Apache-2.0.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@steerable/pack-sdk",
-  "version": "0.6.52",
+  "version": "0.6.55",
   "type": "module",
-  "description": "Scenario pack contract for @steerable/agent-shell (pure types, zero runtime). A scenario pack declares every extension a vertical scenario needs — services, tools, tables, skills, agent seeds, IPC, HTTP routes, preload bridge, renderer slots, branding — and the host composes the selected packs at build time.",
+  "description": "Scenario pack contract for @steerable/agent-shell (pure types, zero runtime). A scenario pack declares every extension a vertical scenario needs — services, tools, tables, skills, agent seeds, HTTP routes, renderer slots, branding — and the host composes the selected packs at build time.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
   "repository": {

package/types/index.d.ts

@@ -2,9 +2,9 @@
  * @steerable/pack-sdk —— 场景智能体包契约（纯类型，零运行时）。
  *
  * 一个「场景包」把一个垂直场景（如某行业的专业工具链……）需要的全部
- * 扩展声明集中在一处：主进程服务/工具/表/技能/智能体种子/IPC/HTTP 路由、
- * preload 桥、渲染层插槽、品牌与打包覆盖。宿主（CS Electron 主进程与
- * BS headless server）按产品组装时选中的包集合，逐个槽位消费这些声明。
+ * 扩展声明集中在一处：Node 宿主服务/工具/表/技能/智能体种子/HTTP 路由、
+ * 渲染层插槽、品牌与打包覆盖。宿主（Tauri 监督的 Node 宿主与 BS
+ * headless server）按产品组装时选中的包集合，逐个槽位消费这些声明。
  *
  * 设计约束：
  *  - 本包是零依赖纯类型：不允许 import 宿主内部模块（tool-router、
@@ -13,7 +13,7 @@
  *  - 槽位只开有真实场景代码论证的（既有场景包 diff 的并集），
  *    不凭空膨胀。新槽位 = 新场景的真实需求驱动。
  *  - 组合发生在构建期：产品的 composition root 静态 import 自己的包；
- *    渲染层受 Electron CSP + preload 白名单约束，不做运行时动态加载。
+ *    渲染层不做运行时动态加载。
  *
  * 渲染层贡献类型在 './web' 子路径（依赖 React 类型，主进程侧勿引）。
  *
@@ -69,7 +69,7 @@ export interface ToolContribution {
 
 /**
  * 主进程长驻领域服务（如 DomainService / DocumentEditService）。
- * 宿主在装配期调用 create，把返回值交给包内工具/IPC/路由使用；
+ * 宿主在装配期调用 create，把返回值交给包内工具/路由使用；
  * 宿主不感知服务类型——包内部通过闭包共享。
  */
 export interface ServiceFactory {
@@ -81,7 +81,7 @@ export interface ServiceFactory {
 }
 
 export interface ServiceCreateContext {
-  /** 向用户面广播事件（CS=IPC webContents.send，BS=SSE 总线）。 */
+  /** 向用户面广播事件（SSE 总线）。 */
   broadcast: (channel: string, payload: unknown) => void;
 }
 
@@ -142,14 +142,7 @@ export interface AgentSeed {
   readonly previousIdentities?: readonly AgentSeedIdentity[];
 }
 
-/** IPC 贡献：channel 必须以前缀 '<packId>:' 开头（注册表强制）。 */
-export interface IpcContribution {
-  readonly channel: string;
-  /** 参数为 renderer 经 preload 透传的序列化载荷。 */
-  readonly handler: (payload: unknown) => Promise<unknown> | unknown;
-}
-
-/** BS 模式 HTTP 路由贡献（/host/<packId>/* 命名空间，见 host/http-routes.ts）。 */
+/** HTTP 路由贡献（/host/<packId>/* 命名空间，见 host/http-routes.ts）。 */
 export interface HttpRouteContribution {
   readonly method: 'GET' | 'POST' | 'PUT' | 'DELETE';
   /** 路径模式，如 '/api/v2/ppt-edits/:id'。必须带包前缀路径段。 */
@@ -170,19 +163,9 @@ export interface MainContribution {
   readonly migrations?: readonly MigrationContribution[];
   readonly skills?: readonly SkillContribution[];
   readonly agentSeeds?: readonly AgentSeed[];
-  readonly ipc?: readonly IpcContribution[];
   readonly httpRoutes?: readonly HttpRouteContribution[];
 }
 
-/**
- * preload 桥白名单：包在 window.electron 下挂 '<packId>' 命名空间。
- * 具体桥接函数由包的 preload 模块实现；这里只声明命名空间占用，
- * 宿主据此做 CSP/白名单装配。
- */
-export interface PreloadContribution {
-  readonly namespace: string;
-}
-
 /**
  * 渲染层组件引用。主进程侧不依赖 React，这里用结构化最小类型；
  * 渲染层注册表（apps/web）消费时收窄到具体组件类型。
@@ -263,7 +246,6 @@ export interface ScenarioPack {
   readonly id: ScenarioId;
   readonly brand: BrandSpec;
   readonly main?: MainContribution;
-  readonly preload?: PreloadContribution;
   readonly renderer?: RendererContribution;
   readonly packaging?: PackagingSpec;
 }