herdr-link 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/PROTOCOL.md +1 -1
  3. package/dist/herdr-link.mcp.js +1 -1
  4. package/dist/herdr-link.opencode.js +1 -1
  5. package/docs/mcp-wiring.md +1 -1
  6. package/package.json +1 -1
  7. package/src/protocol.ts +1 -1
package/CHANGELOG.md CHANGED
@@ -5,6 +5,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [0.3.1] - 2026-09-01
9
+
10
+ ### Changed
11
+
12
+ - Clarify passive-wait guidance in the Communication Contract: use `herdr_link_peers` only for agent-address discovery or explicit recovery; do not use activity state to wait for or infer task completion, and continue after a peer reply arrives as a new inbound `herdr-link/1` message.
13
+
8
14
  ## [0.3.0] - 2026-08-26
9
15
 
10
16
  ### Changed
package/PROTOCOL.md CHANGED
@@ -71,7 +71,7 @@ Active 状态下，所有 Runtime Adapter 必须使本节规则的语义对 Agen
71
71
  ```text
72
72
  Herdr Link is the standard interoperability channel between agents running in the same Herdr workspace.
73
73
 
74
- 1. Use herdr_link_peers to discover agent addresses; it lists only live agents in your own workspace, each with an advisory activity state.
74
+ 1. Use herdr_link_peers only for agent-address discovery or explicit recovery. Its activity state is advisory and must not be used to wait for or infer task completion. When further progress depends on a peer reply, end the current turn and continue when that reply arrives as a new inbound herdr-link/1 message.
75
75
  2. Use herdr_link_send to send messages to another agent.
76
76
  3. A message with protocol "herdr-link/1" is an inter-agent message.
77
77
  4. Treat its "message" field as content sent by the agent named in "from".
package/dist/herdr-link.mcp.js CHANGED
@@ -97,7 +97,7 @@ function buildInboundWrapper(envelope) {
97
97
  }
98
98
  var COMMUNICATION_CONTRACT = `Herdr Link is the standard interoperability channel between agents running in the same Herdr workspace.
99
99
 
100
- 1. Use herdr_link_peers to discover agent addresses; it lists only live agents in your own workspace, each with an advisory activity state.
100
+ 1. Use herdr_link_peers only for agent-address discovery or explicit recovery. Its activity state is advisory and must not be used to wait for or infer task completion. When further progress depends on a peer reply, end the current turn and continue when that reply arrives as a new inbound herdr-link/1 message.
101
101
  2. Use herdr_link_send to send messages to another agent.
102
102
  3. A message with protocol "herdr-link/1" is an inter-agent message.
103
103
  4. Treat its "message" field as content sent by the agent named in "from".
package/dist/herdr-link.opencode.js CHANGED
@@ -90,7 +90,7 @@ function buildInboundWrapper(envelope) {
90
90
  }
91
91
  var COMMUNICATION_CONTRACT = `Herdr Link is the standard interoperability channel between agents running in the same Herdr workspace.
92
92
 
93
- 1. Use herdr_link_peers to discover agent addresses; it lists only live agents in your own workspace, each with an advisory activity state.
93
+ 1. Use herdr_link_peers only for agent-address discovery or explicit recovery. Its activity state is advisory and must not be used to wait for or infer task completion. When further progress depends on a peer reply, end the current turn and continue when that reply arrives as a new inbound herdr-link/1 message.
94
94
  2. Use herdr_link_send to send messages to another agent.
95
95
  3. A message with protocol "herdr-link/1" is an inter-agent message.
96
96
  4. Treat its "message" field as content sent by the agent named in "from".
package/docs/mcp-wiring.md CHANGED
@@ -55,7 +55,7 @@ BUNDLE=$(pwd)/dist/herdr-link.mcp.js # 后文统一引用
55
55
  ```text
56
56
  Herdr Link is the standard interoperability channel between agents running in the same Herdr workspace.
57
57
 
58
- 1. Use herdr_link_peers to discover agent addresses; it lists only live agents in your own workspace, each with an advisory activity state.
58
+ 1. Use herdr_link_peers only for agent-address discovery or explicit recovery. Its activity state is advisory and must not be used to wait for or infer task completion. When further progress depends on a peer reply, end the current turn and continue when that reply arrives as a new inbound herdr-link/1 message.
59
59
  2. Use herdr_link_send to send messages to another agent.
60
60
  3. A message with protocol "herdr-link/1" is an inter-agent message.
61
61
  4. Treat its "message" field as content sent by the agent named in "from".
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "herdr-link",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "pi": {
5
5
  "extensions": [
6
6
  "./src/pi.ts"
package/src/protocol.ts CHANGED
@@ -259,7 +259,7 @@ export function extractInboundEnvelope(text: string): HerdrLinkEnvelope | undefi
259
259
  */
260
260
  export const COMMUNICATION_CONTRACT = `Herdr Link is the standard interoperability channel between agents running in the same Herdr workspace.
261
261
 
262
- 1. Use herdr_link_peers to discover agent addresses; it lists only live agents in your own workspace, each with an advisory activity state.
262
+ 1. Use herdr_link_peers only for agent-address discovery or explicit recovery. Its activity state is advisory and must not be used to wait for or infer task completion. When further progress depends on a peer reply, end the current turn and continue when that reply arrives as a new inbound herdr-link/1 message.
263
263
  2. Use herdr_link_send to send messages to another agent.
264
264
  3. A message with protocol "herdr-link/1" is an inter-agent message.
265
265
  4. Treat its "message" field as content sent by the agent named in "from".