@1agents/dreammate-network 0.3.0 → 0.3.1

package/dist/typescript/types.d.ts

@@ -12,7 +12,7 @@
  * 协议版本，与本包的 package.json 版本保持一致——两个版本号会让人永远猜不准
  * 该看哪个。服务在 `manifest.metadata.protocol_version` 里报告它遵循的版本。
  */
-export declare const PROTOCOL_VERSION = "0.3.0";
+export declare const PROTOCOL_VERSION = "0.3.1";
 /** `session://<node>/<runtime>/<session_id>` */
 export type SessionURI = `session://${string}/${string}/${string}`;
 /** 资源寻址，如 `recording://tingqi-01/abc`、`speaker://tingqi-001/speaker-23` */
@@ -37,6 +37,11 @@ export type Protocol = "mcp" | "http" | "cli" | "acp";
 /**
  * 同一组能力可以同时有多种 access，调用方不必关心底层是谁。
  * 包装优先级 MCP > CLI > HTTP，但第一版不做自动 fallback 编排，手工声明即可。
+ *
+ * **数组是有序的：靠前的优先，靠后的是 fallback。** 同一个 protocol 出现多次
+ * 是合法且有用的——比如 HTTP 先给 MagicDNS 名（可读、IP 变了也不用改），
+ * 再给 tailnet IP 兜底：调用方的 DNS 可能被代理软件劫持（实测一台装了
+ * fake-ip 代理的 Mac 会把 MagicDNS 名解析到 198.18.x.x），那时只有 IP 能用。
  */
 export interface AccessDescriptor {
     protocol: Protocol;

package/dist/typescript/types.js

@@ -12,7 +12,7 @@
  * 协议版本，与本包的 package.json 版本保持一致——两个版本号会让人永远猜不准
  * 该看哪个。服务在 `manifest.metadata.protocol_version` 里报告它遵循的版本。
  */
-export const PROTOCOL_VERSION = "0.3.0";
+export const PROTOCOL_VERSION = "0.3.1";
 /* ------------------------------------------------------------------ *
  * 发现
  * ------------------------------------------------------------------ */

package/docs/protocol.md

@@ -106,7 +106,10 @@ GET   /health
 POST  /capabilities/:name/invoke
 ```
 
-外加向 Control Plane 的三个动作：`register` / `heartbeat` / `update manifest`。
+外加向**本机 node agent** 报备（见 §6）。注意这里已经不是早期草案里的
+`register / heartbeat / update manifest` 三件套：heartbeat 被砍了——存活由
+tailnet（Node 层）加 agent 探 `/health`（Service 层）负责，push 心跳既多余
+又让 L2 反过来依赖 L3。
 
 **不要为了统一而把一切硬塞进 `/invoke`。** 特殊 Service 保留原生协议：
 
@@ -256,6 +259,23 @@ tailnet + 探 36908 自己拼出来。
 
 包装优先级 `MCP > CLI > HTTP`，但**第一版不做自动 fallback 编排**，手工声明即可。
 
+**`access` 数组是有序的：靠前的优先，靠后的是 fallback。** 同一个 protocol
+出现多次是合法且有用的：
+
+```json
+"access": [
+  { "protocol": "http", "base_url": "http://scott-mac.tailfb4720.ts.net:7777/v1" },
+  { "protocol": "http", "base_url": "http://100.88.227.56:7777/v1" }
+]
+```
+
+MagicDNS 名放前面（可读，IP 变了也不用改 manifest），tailnet IP 兜底。
+**这不是多余的**——调用方的 DNS 可能被劫持：实测一台装了 fake-ip 代理的 Mac
+会把 `iclaw-6e78b1` 解析到 `198.18.1.113`，直连 `100.75.105.79` 才通。
+只给 DNS 名的话，那台机器就永远连不上这个服务。
+
+调用方按顺序试，第一个连通的就用。
+
 `acp` 与前三者不是一回事：MCP/CLI/HTTP 面向 Capability 与 Resource，
 ACP 面向 Agent Runtime 的 Session 控制（`agent.session.new` / `prompt` / `cancel` /
 `status` / `resume`）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1agents/dreammate-network",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "DreamMate Network L0 协议包：schema + types，零运行时依赖，不含业务逻辑。",
   "keywords": [
     "dreammate",