@moonan_ai/sdk 0.0.5-alpha1 → 0.0.5-alpha2

package/README.md

@@ -59,20 +59,30 @@ export default defineFacet((api) => {
 ## 约定
 
 - 契约在两端**各写一份**：Chord 认指纹（名字、版本、成员、类型住在哪个宿主），不认模块实例。
-- 注册表贡献（`Routes`、`Panels`、`DataCodecs`、`ModelProviders`）必须来自 `{ lifetime: "host" }` 的对象。
-- 需要统一导出/导入的数据放 `DataStore`，并注册 `DataCodecs`；需要给其他插件用模型时注册 `ModelProviders`。
+- 注册表贡献（`Routes`、`Panels`、`DataCodecs`）必须来自 `{ lifetime: "host" }` 的对象。
+- 功能专属注册表由对应的插件包定义，例如 ai-gateway 的 `ModelProviders`；SDK 只提供通用的 `defineRegistry`。
+- 需要统一导出/导入的数据放 `DataStore`，并注册 `DataCodecs`；功能能力（如模型）由对应插件包自己定义注册表。
 - 服务端宿主名固定为 `"moonan"`；写别的名字，`api.serve` 会当场拒绝。
 - 浏览器切面是**单个 ESM 文件**：浏览器没有模块 hook，重载只换入口。
 
-## 统一数据与模型
+## 统一数据
 
 ```js
-import { DataCodecs, DataStore, ModelProviders } from "@moonan_ai/sdk";
+import { DataCodecs, DataStore } from "@moonan_ai/sdk";
 ```
 
 - `DataStore` 是平台唯一的统一数据文件（local、host-lifetime）；`read` 返回 `{ value, version }`，`update` 是串行读改写，`exportAll`/`importAll` 由平台 HTTP 表面调用。
 - `DataCodecs` 是插件贡献的导出/导入 codec 注册表；没有 codec 的 namespace 不会进入统一导出。
-- `ModelProviders` 是服务端模型提供商注册表；`list()` 是 key-free 目录，`runtime()` 是 server-only 运行时，不能给浏览器。
+
+## 功能注册表
+
+功能专属的注册表不属于 SDK。例如模型能力由 ai-gateway 自己定义并导出：
+
+```js
+import { ModelProviders } from "@moonan_ai/ai-gateway/model-provider";
+```
+
+消费方按 id 查找，平台和 SDK 不需要认识 `ModelInfo`。后续的图像、语音等能力也应各自定义自己的注册表。
 
 完整写法：<https://github.com/Pheobe-Southwood/Moonan/blob/main/docs/plugins.md> ·
 词汇表：<https://github.com/Pheobe-Southwood/Moonan/blob/main/CONTEXT.md>

package/dist/index.js

@@ -2,14 +2,12 @@
  * `@moonan_ai/sdk` — everything a plugin needs on either side of the wire.
  *
  * The root entry is shared by the server facet and the browser facet: contracts,
- * registries (including `DataCodecs` and `ModelProviders`) and the Chord primitives they
- * are built from. Browser-only surface (the `Panels` registry and the React hooks) lives
+ * registries (including `DataCodecs`) and the Chord primitives they are built from. Browser-only surface (the `Panels` registry and the React hooks) lives
  * in `@moonan_ai/sdk/web`, because it needs React and the root entry must stay importable
  * from a Node facet.
  */
 export { WebFacetCatalog, FacetSetSchema, WebFacetSchema, } from "./web-facet-catalog.js";
 export { DataStore, DataCodecs, DataBundleSchema, DataImportReportSchema, DataStoreStorageInfoSchema, StoredDatasetSchema, defineDataset, } from "./data.js";
-export { ModelProviders, } from "./model-provider.js";
 export { Routes } from "./routes.js";
 /** Chord primitives, re-exported so a plugin needs two dependencies instead of three. */
 export { ChordError, defineFacet, defineRegistry, forbidden, hostFamily, hostNamed, invalid, isChordError, local, method, opaque, remote, } from "@earendil-works/chord";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACN,eAAe,EACf,cAAc,EACd,cAAc,GAGd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,aAAa,GAOb,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,GAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAExD,yFAAyF;AACzF,OAAO,EACN,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,OAAO,EACP,YAAY,EACZ,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,GAiBN,MAAM,uBAAuB,CAAC;AAE/B,uFAAuF;AACvF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,UAAU,EACV,kBAAkB,GAElB,MAAM,+BAA+B,CAAC;AAEvC,yDAAyD;AACzD,OAAO,EAAE,IAAI,EAA6B,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACN,eAAe,EACf,cAAc,EACd,cAAc,GAGd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,aAAa,GAOb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAExD,yFAAyF;AACzF,OAAO,EACN,UAAU,EACV,WAAW,EACX,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,OAAO,EACP,YAAY,EACZ,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,GAiBN,MAAM,uBAAuB,CAAC;AAE/B,uFAAuF;AACvF,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,UAAU,EACV,kBAAkB,GAElB,MAAM,+BAA+B,CAAC;AAEvC,yDAAyD;AACzD,OAAO,EAAE,IAAI,EAA6B,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonan_ai/sdk",
-  "version": "0.0.5-alpha1",
+  "version": "0.0.5-alpha2",
   "description": "Moonan plugin SDK: contracts, registries and browser hooks for plugin authors.",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -2,8 +2,7 @@
  * `@moonan_ai/sdk` — everything a plugin needs on either side of the wire.
  *
  * The root entry is shared by the server facet and the browser facet: contracts,
- * registries (including `DataCodecs` and `ModelProviders`) and the Chord primitives they
- * are built from. Browser-only surface (the `Panels` registry and the React hooks) lives
+ * registries (including `DataCodecs`) and the Chord primitives they are built from. Browser-only surface (the `Panels` registry and the React hooks) lives
  * in `@moonan_ai/sdk/web`, because it needs React and the root entry must stay importable
  * from a Node facet.
  */
@@ -29,11 +28,6 @@ export {
 	type DatasetExportOptions,
 	type StoredDataset,
 } from "./data.js";
-export {
-	ModelProviders,
-	type ModelInfo,
-	type ModelProvider,
-} from "./model-provider.js";
 export { Routes, type RouteHandler } from "./routes.js";
 
 /** Chord primitives, re-exported so a plugin needs two dependencies instead of three. */

package/dist/model-provider.js

@@ -1,5 +0,0 @@
-import { defineRegistry } from "@earendil-works/chord";
-export const ModelProviders = defineRegistry("moonan.model-providers", {
-    conflict: "error",
-});
-//# sourceMappingURL=model-provider.js.map

package/dist/model-provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"model-provider.js","sourceRoot":"","sources":["../src/model-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA0CvD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAgB,wBAAwB,EAAE;IACrF,QAAQ,EAAE,OAAO;CACjB,CAAC,CAAC"}

package/src/model-provider.ts

@@ -1,45 +0,0 @@
-import { defineRegistry } from "@earendil-works/chord";
-
-/**
- * Provider-neutral metadata for one configured chat model.
- *
- * This is plain JSON: the registry value never crosses a link, but keeping the catalog
- * serializable lets a plugin expose it over HTTP or in a panel without a second shape.
- */
-export interface ModelInfo {
-	readonly providerId: string;
-	readonly modelId: string;
-	readonly name: string;
-	readonly contextWindow?: number;
-	readonly maxTokens?: number;
-	readonly input: readonly ("text" | "image")[];
-	readonly reasoning: boolean;
-}
-
-/**
- * A model provider contribution.
- *
- * `list()` is the key-free catalog. `runtime()` is a server-only handle whose concrete
- * shape belongs to the provider package; ai-gateway returns its pi-ai `MutableModels`
- * there. The SDK stays free of pi-ai so a generic plugin does not inherit an AI dependency.
- *
- * A consumer looks the provider up with the code version of its root:
- *
- * ```ts
- * const providers = api.registry(ModelProviders);
- * const provider = providers.get("ai-gateway", ctx);
- * ```
- *
- * The registry value is not a Chord contract: there is no `uses` entry and no wire
- * compatibility rule. Its table is replaced with each code version like every registry.
- */
-export interface ModelProvider {
-	readonly id: string;
-	readonly title: string;
-	list(): readonly ModelInfo[];
-	runtime(): unknown;
-}
-
-export const ModelProviders = defineRegistry<ModelProvider>("moonan.model-providers", {
-	conflict: "error",
-});