agent-embassy 1.3.0 → 1.4.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 (80) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/CONTRIBUTING.md +25 -9
  3. package/README.md +40 -16
  4. package/README.zh-CN.md +35 -14
  5. package/SECURITY.md +13 -7
  6. package/dist/src/gateway/claude-helper-protocol.d.ts +1 -0
  7. package/dist/src/gateway/claude-helper-protocol.js +4 -2
  8. package/dist/src/gateway/claude-helper-protocol.js.map +1 -1
  9. package/dist/src/gateway/claude-helper-supervisor.d.ts +1 -0
  10. package/dist/src/gateway/claude-helper-supervisor.js +3 -0
  11. package/dist/src/gateway/claude-helper-supervisor.js.map +1 -1
  12. package/dist/src/gateway/claude-peer.d.ts +2 -2
  13. package/dist/src/gateway/claude-peer.js +2 -1
  14. package/dist/src/gateway/claude-peer.js.map +1 -1
  15. package/dist/src/gateway/cli-copy.d.ts +1 -1
  16. package/dist/src/gateway/cli-copy.en.d.ts +4 -3
  17. package/dist/src/gateway/cli-copy.en.js +4 -2
  18. package/dist/src/gateway/cli-copy.en.js.map +1 -1
  19. package/dist/src/gateway/cli-copy.js +1 -0
  20. package/dist/src/gateway/cli-copy.js.map +1 -1
  21. package/dist/src/gateway/cli-copy.zh-CN.d.ts +4 -3
  22. package/dist/src/gateway/cli-copy.zh-CN.js +4 -2
  23. package/dist/src/gateway/cli-copy.zh-CN.js.map +1 -1
  24. package/dist/src/gateway/cli.d.ts +1 -1
  25. package/dist/src/gateway/cli.js +12 -1
  26. package/dist/src/gateway/cli.js.map +1 -1
  27. package/dist/src/gateway/codex-app-server.d.ts +1 -1
  28. package/dist/src/gateway/codex-app-server.js +32 -11
  29. package/dist/src/gateway/codex-app-server.js.map +1 -1
  30. package/dist/src/gateway/compatibility.js +1 -1
  31. package/dist/src/gateway/compatibility.js.map +1 -1
  32. package/dist/src/gateway/config.d.ts +1 -1
  33. package/dist/src/gateway/control.d.ts +1 -1
  34. package/dist/src/gateway/control.js +5 -3
  35. package/dist/src/gateway/control.js.map +1 -1
  36. package/dist/src/gateway/dashboard-copy.d.ts +1 -1
  37. package/dist/src/gateway/dashboard-copy.en.d.ts +15 -1
  38. package/dist/src/gateway/dashboard-copy.en.js +25 -11
  39. package/dist/src/gateway/dashboard-copy.en.js.map +1 -1
  40. package/dist/src/gateway/dashboard-copy.js +15 -1
  41. package/dist/src/gateway/dashboard-copy.js.map +1 -1
  42. package/dist/src/gateway/dashboard-copy.zh-CN.d.ts +15 -1
  43. package/dist/src/gateway/dashboard-copy.zh-CN.js +25 -11
  44. package/dist/src/gateway/dashboard-copy.zh-CN.js.map +1 -1
  45. package/dist/src/gateway/dashboard-model.d.ts +2 -3
  46. package/dist/src/gateway/dashboard-model.js +118 -30
  47. package/dist/src/gateway/dashboard-model.js.map +1 -1
  48. package/dist/src/gateway/dashboard.js +22 -9
  49. package/dist/src/gateway/dashboard.js.map +1 -1
  50. package/dist/src/gateway/instance-lease.d.ts +2 -3
  51. package/dist/src/gateway/instance-lease.js +17 -140
  52. package/dist/src/gateway/instance-lease.js.map +1 -1
  53. package/dist/src/gateway/live-dashboard-app/app.js +45 -18
  54. package/dist/src/gateway/live-dashboard-http.js +1 -1
  55. package/dist/src/gateway/live-dashboard-http.js.map +1 -1
  56. package/dist/src/gateway/progress-watch-machine.d.ts +6 -5
  57. package/dist/src/gateway/progress-watch-machine.js +6 -6
  58. package/dist/src/gateway/progress-watch-machine.js.map +1 -1
  59. package/dist/src/gateway/provenance-envelope.d.ts +1 -0
  60. package/dist/src/gateway/provenance-envelope.js +10 -3
  61. package/dist/src/gateway/provenance-envelope.js.map +1 -1
  62. package/dist/src/gateway/providers.d.ts +1 -0
  63. package/dist/src/gateway/providers.js +6 -0
  64. package/dist/src/gateway/providers.js.map +1 -1
  65. package/dist/src/gateway/service.d.ts +2 -0
  66. package/dist/src/gateway/service.js +25 -8
  67. package/dist/src/gateway/service.js.map +1 -1
  68. package/dist/src/gateway/store.d.ts +9 -21
  69. package/dist/src/gateway/store.js +284 -122
  70. package/dist/src/gateway/store.js.map +1 -1
  71. package/dist/src/gateway/types.d.ts +1 -2
  72. package/dist/src/gateway/types.js.map +1 -1
  73. package/docs/CONFIGURATION.md +102 -0
  74. package/docs/CONFIGURATION.zh-CN.md +72 -0
  75. package/docs/DASHBOARD.md +103 -0
  76. package/docs/DASHBOARD.zh-CN.md +47 -0
  77. package/docs/DELIVERY.md +84 -0
  78. package/docs/DELIVERY.zh-CN.md +53 -0
  79. package/docs/GATEWAY-ARCHITECTURE.md +183 -99
  80. package/package.json +8 -4
@@ -8,12 +8,15 @@ export const progressWatchOutcomes = [
8
8
  ];
9
9
  export const progressWatchJournalKinds = [
10
10
  "opened",
11
+ "replaced",
11
12
  "activity",
12
13
  "nudge",
13
14
  "worker_reported_complete",
14
15
  "capability_degraded",
16
+ "conversation_rebound",
15
17
  "done",
16
18
  "unresponsive",
19
+ "pair_removed",
17
20
  "endpoint_retired",
18
21
  "disabled",
19
22
  ];
@@ -57,12 +60,13 @@ export function createProgressWatchMachine(input) {
57
60
  degradedNoticeSent: false,
58
61
  };
59
62
  }
60
- /** Pure, deterministic owner-ended progress-watch transition function. */
63
+ /** Pure, deterministic completion-ended progress-watch transition function. */
61
64
  export function transitionProgressWatch(state, event) {
62
65
  const at = event.at;
63
66
  const timestamp = iso(at);
64
67
  switch (event.type) {
65
68
  case "owner_done":
69
+ case "worker_done":
66
70
  return settle("done");
67
71
  case "endpoint_retired":
68
72
  return settle("endpoint_retired");
@@ -70,7 +74,6 @@ export function transitionProgressWatch(state, event) {
70
74
  return settle("disabled");
71
75
  case "activity":
72
76
  case "route_activity": {
73
- const workerReportedComplete = event.type === "activity" && event.workerReportedComplete === true;
74
77
  return {
75
78
  state: {
76
79
  ...state,
@@ -79,9 +82,6 @@ export function transitionProgressWatch(state, event) {
79
82
  phase: "quiet",
80
83
  nudgeCount: 0,
81
84
  nextActionAt: plus(at, state.idleMs),
82
- ...(workerReportedComplete
83
- ? { workerReportedCompleteAt: timestamp }
84
- : {}),
85
85
  },
86
86
  effects: [],
87
87
  };
@@ -105,7 +105,7 @@ export function transitionProgressWatch(state, event) {
105
105
  capability: "route",
106
106
  degradedNoticeSent: true,
107
107
  },
108
- effects: notify ? [{ type: "notify_capability_degraded" }] : [],
108
+ effects: notify ? [{ type: "record_capability_degraded" }] : [],
109
109
  };
110
110
  }
111
111
  case "nudge_deferred": {
@@ -1 +1 @@
1
- {"version":3,"file":"progress-watch-machine.js","sourceRoot":"","sources":["../../../src/gateway/progress-watch-machine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"progress-watch-machine.js","sourceRoot":"","sources":["../../../src/gateway/progress-watch-machine.ts"],"names":[],"mappings":"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"}
@@ -7,6 +7,7 @@ export type ComposeProvenanceEnvelopeInput = Readonly<{
7
7
  targetAlias: string;
8
8
  conversationId: string;
9
9
  body: string;
10
+ progressWatchActive?: true;
10
11
  }>;
11
12
  /**
12
13
  * Adds broker-owned, Claude-compatible textual framing at the provider write
@@ -4,7 +4,7 @@ export const PROVENANCE_RAW_BODY_MAX_BYTES = 16 * 1024;
4
4
  export const PROVENANCE_ENVELOPE_MAX_BYTES = 64 * 1024;
5
5
  const ALIAS_PATTERN = /^[a-z][a-z0-9_-]{0,31}@[a-z0-9](?:[a-z0-9.-]{0,61}[a-z0-9])?$/;
6
6
  const CONVERSATION_ID_PATTERN = /^conv_[A-Za-z0-9_-]{16,64}$/;
7
- const RESERVED_TAG_PATTERN = /<(?=\/?(?:cross-session-message|embassy-reply-hint)(?:[>\s/]|$))/giu;
7
+ const RESERVED_TAG_PATTERN = /<(?=\/?(?:cross-session-message|embassy-reply-hint|embassy-track-active)(?:[>\s/]|$))/giu;
8
8
  const CLAUDE_FROM_NAME_MAX_CODEPOINTS = 64;
9
9
  const LONG_ALIAS_PREFIX_CODEPOINTS = 47;
10
10
  const LONG_ALIAS_HASH_HEX_LENGTH = 16;
@@ -24,7 +24,9 @@ function validateInput(input) {
24
24
  !ALIAS_PATTERN.test(input.targetAlias) ||
25
25
  typeof input.conversationId !== "string" ||
26
26
  !CONVERSATION_ID_PATTERN.test(input.conversationId) ||
27
- typeof input.body !== "string") {
27
+ typeof input.body !== "string" ||
28
+ (input.progressWatchActive !== undefined &&
29
+ input.progressWatchActive !== true)) {
28
30
  invalidEnvelope();
29
31
  }
30
32
  if (Buffer.byteLength(input.body, "utf8") > PROVENANCE_RAW_BODY_MAX_BYTES) {
@@ -69,9 +71,14 @@ export function composeProvenanceEnvelope(input) {
69
71
  ` reply-as="${input.targetAlias}"${exactSourceAttribute}>` +
70
72
  `Reply by running \`${replyCommand}\` with the reply body on stdin. ` +
71
73
  "Caller, conversation, and route policy are rechecked.</embassy-reply-hint>";
74
+ const trackMarker = input.progressWatchActive === true
75
+ ? "\n<embassy-track-active>Progress supervision is active for this " +
76
+ "conversation. Reply with a leading `DONE:` when the assigned work " +
77
+ "is complete; that completion closes the watch.</embassy-track-active>"
78
+ : "";
72
79
  const body = neutralizeReservedTags(input.body);
73
80
  const envelope = `<cross-session-message from-name="${fromName}"${conversationAttribute}>\n` +
74
- `${hint}\n${body}\n</cross-session-message>`;
81
+ `${hint}${trackMarker}\n${body}\n</cross-session-message>`;
75
82
  if (Buffer.byteLength(envelope, "utf8") > PROVENANCE_ENVELOPE_MAX_BYTES) {
76
83
  envelopeTooLarge();
77
84
  }
@@ -1 +1 @@
1
- {"version":3,"file":"provenance-envelope.js","sourceRoot":"","sources":["../../../src/gateway/provenance-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,MAAM,aAAa,GACjB,+DAA+D,CAAC;AAClE,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAC9D,MAAM,oBAAoB,GACxB,qEAAqE,CAAC;AACxE,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAC3C,MAAM,4BAA4B,GAAG,EAAE,CAAC;AACxC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAYtC,SAAS,eAAe;IACtB,MAAM,IAAI,WAAW,CACnB,6BAA6B,EAC7B,8CAA8C,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,IAAI,WAAW,CACnB,+BAA+B,EAC/B,iDAAiD,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAqC;IAC1D,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,SAAS,KAAK,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC;QAC7D,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QACtC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QACtC,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;QACxC,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;QACnD,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAC9B,CAAC;QACD,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,6BAA6B,EAAE,CAAC;QAC1E,gBAAgB,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IAIvC,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC9B,IAAI,UAAU,CAAC,MAAM,IAAI,+BAA+B,EAAE,CAAC;QACzD,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC;SAChC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;SACrB,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACxC,OAAO;QACL,YAAY,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE;QACvF,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAqC;IAErC,aAAa,CAAC,KAAK,CAAC,CAAC;IAErB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,QAAQ,GACZ,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACzE,MAAM,qBAAqB,GACzB,KAAK,CAAC,SAAS,KAAK,OAAO;QACzB,CAAC,CAAC,kBAAkB,KAAK,CAAC,cAAc,GAAG;QAC3C,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,oBAAoB,GACxB,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS;QAC/C,CAAC,CAAC,gBAAgB,KAAK,CAAC,WAAW,GAAG;QACtC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,YAAY,GAChB,gCAAgC,KAAK,CAAC,cAAc,EAAE;QACtD,YAAY,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,IAAI,GACR,qCAAqC,KAAK,CAAC,cAAc,GAAG;QAC5D,cAAc,KAAK,CAAC,WAAW,IAAI,oBAAoB,GAAG;QAC1D,sBAAsB,YAAY,mCAAmC;QACrE,4EAA4E,CAAC;IAC/E,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GACZ,qCAAqC,QAAQ,IAAI,qBAAqB,KAAK;QAC3E,GAAG,IAAI,KAAK,IAAI,4BAA4B,CAAC;IAE/C,IACE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,6BAA6B,EACnE,CAAC;QACD,gBAAgB,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
1
+ {"version":3,"file":"provenance-envelope.js","sourceRoot":"","sources":["../../../src/gateway/provenance-envelope.ts"],"names":[],"mappings":"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"}
@@ -160,6 +160,7 @@ export declare class LocalClaudeGatewayProvider implements GatewayProviderAdapte
160
160
  text: string;
161
161
  expectsReply: boolean;
162
162
  deadlineAt: string;
163
+ progressWatchActive?: true;
163
164
  }): Promise<GatewayAdapterDispatchResult>;
164
165
  releaseRoute(routeHandle: string): Promise<void>;
165
166
  close(): Promise<void>;
@@ -864,6 +864,9 @@ export class LocalClaudeGatewayProvider {
864
864
  targetAlias: input.targetAlias,
865
865
  conversationId: input.conversationId,
866
866
  body: input.text,
867
+ ...(input.progressWatchActive === true
868
+ ? { progressWatchActive: true }
869
+ : {}),
867
870
  });
868
871
  }
869
872
  catch (error) {
@@ -1971,6 +1974,9 @@ export class LocalCodexGatewayProvider {
1971
1974
  targetAlias: input.targetAlias,
1972
1975
  conversationId: input.conversationId,
1973
1976
  body: input.text,
1977
+ ...(input.progressWatchActive === true
1978
+ ? { progressWatchActive: true }
1979
+ : {}),
1974
1980
  });
1975
1981
  }
1976
1982
  catch (error) {