@aria-cli/tools 1.0.12 → 1.0.14

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 (233) hide show
  1. package/dist/index.js +378 -70
  2. package/dist/network-runtime/index.js +8 -12
  3. package/dist-cjs/index.js +400 -435
  4. package/dist-cjs/network-runtime/index.js +8 -172
  5. package/package.json +8 -6
  6. package/dist/.tsbuildinfo +0 -1
  7. package/dist/ask-user-interaction.js +0 -22
  8. package/dist/cache/web-cache.js +0 -66
  9. package/dist/definitions/arion.js +0 -104
  10. package/dist/definitions/browser/browser.js +0 -418
  11. package/dist/definitions/browser/index.js +0 -4
  12. package/dist/definitions/browser/pw-downloads.js +0 -114
  13. package/dist/definitions/browser/pw-interactions.js +0 -199
  14. package/dist/definitions/browser/pw-responses.js +0 -76
  15. package/dist/definitions/browser/pw-session.js +0 -310
  16. package/dist/definitions/browser/pw-shared.js +0 -66
  17. package/dist/definitions/browser/pw-snapshot.js +0 -301
  18. package/dist/definitions/browser/pw-state.js +0 -62
  19. package/dist/definitions/browser/types.js +0 -4
  20. package/dist/definitions/code-intelligence.js +0 -470
  21. package/dist/definitions/core.js +0 -109
  22. package/dist/definitions/delegation.js +0 -512
  23. package/dist/definitions/deploy.js +0 -65
  24. package/dist/definitions/filesystem.js +0 -196
  25. package/dist/definitions/frg.js +0 -63
  26. package/dist/definitions/index.js +0 -20
  27. package/dist/definitions/memory.js +0 -123
  28. package/dist/definitions/messaging.js +0 -625
  29. package/dist/definitions/meta.js +0 -349
  30. package/dist/definitions/network.js +0 -159
  31. package/dist/definitions/outlook.js +0 -277
  32. package/dist/definitions/patch/apply-patch.js +0 -184
  33. package/dist/definitions/patch/fuzzy-match.js +0 -166
  34. package/dist/definitions/patch/index.js +0 -1
  35. package/dist/definitions/patch/patch-parser.js +0 -207
  36. package/dist/definitions/patch/sandbox-paths.js +0 -105
  37. package/dist/definitions/process/index.js +0 -4
  38. package/dist/definitions/process/process-registry.js +0 -213
  39. package/dist/definitions/process/process.js +0 -386
  40. package/dist/definitions/process/pty-keys.js +0 -254
  41. package/dist/definitions/process/session-slug.js +0 -142
  42. package/dist/definitions/quip.js +0 -195
  43. package/dist/definitions/search.js +0 -60
  44. package/dist/definitions/session-history.js +0 -69
  45. package/dist/definitions/shell.js +0 -181
  46. package/dist/definitions/slack.js +0 -180
  47. package/dist/definitions/web.js +0 -109
  48. package/dist/executors/apply-patch.js +0 -901
  49. package/dist/executors/arion.js +0 -119
  50. package/dist/executors/code-intelligence.js +0 -882
  51. package/dist/executors/deploy.js +0 -848
  52. package/dist/executors/filesystem.js +0 -1122
  53. package/dist/executors/frg-freshness.js +0 -576
  54. package/dist/executors/frg.js +0 -298
  55. package/dist/executors/index.js +0 -46
  56. package/dist/executors/learning-meta.js +0 -1146
  57. package/dist/executors/lsp-client.js +0 -296
  58. package/dist/executors/memory.js +0 -750
  59. package/dist/executors/meta.js +0 -220
  60. package/dist/executors/process-registry.js +0 -465
  61. package/dist/executors/pty-session-store.js +0 -30
  62. package/dist/executors/pty.js +0 -271
  63. package/dist/executors/restart.js +0 -119
  64. package/dist/executors/search-freshness.js +0 -195
  65. package/dist/executors/search-types.js +0 -52
  66. package/dist/executors/search.js +0 -66
  67. package/dist/executors/self-diagnose.js +0 -398
  68. package/dist/executors/session-history.js +0 -283
  69. package/dist/executors/shell-safety.js +0 -473
  70. package/dist/executors/shell.js +0 -954
  71. package/dist/executors/utils.js +0 -33
  72. package/dist/executors/web.js +0 -542
  73. package/dist/extraction/content-extraction.js +0 -235
  74. package/dist/extraction/index.js +0 -4
  75. package/dist/headless-control-contract.js +0 -967
  76. package/dist/local-control-http-auth.js +0 -2
  77. package/dist/mcp/client.js +0 -181
  78. package/dist/mcp/connection.js +0 -480
  79. package/dist/mcp/index.js +0 -10
  80. package/dist/mcp/jsonrpc.js +0 -144
  81. package/dist/mcp/types.js +0 -7
  82. package/dist/network-control-adapter.js +0 -72
  83. package/dist/network-runtime/address-types.js +0 -165
  84. package/dist/network-runtime/db-owner-fencing.js +0 -69
  85. package/dist/network-runtime/delivery-receipts.js +0 -267
  86. package/dist/network-runtime/direct-endpoint-authority.js +0 -25
  87. package/dist/network-runtime/local-control-contract.js +0 -627
  88. package/dist/network-runtime/node-store-contract.js +0 -34
  89. package/dist/network-runtime/pair-route-contract.js +0 -77
  90. package/dist/network-runtime/peer-capabilities.js +0 -28
  91. package/dist/network-runtime/peer-principal-ref.js +0 -12
  92. package/dist/network-runtime/peer-state-machine.js +0 -121
  93. package/dist/network-runtime/protocol-schemas.js +0 -205
  94. package/dist/network-runtime/runtime-bootstrap-contract.js +0 -60
  95. package/dist/outlook/desktop-session.js +0 -279
  96. package/dist/policy.js +0 -149
  97. package/dist/providers/brave.js +0 -62
  98. package/dist/providers/duckduckgo.js +0 -176
  99. package/dist/providers/exa.js +0 -63
  100. package/dist/providers/firecrawl.js +0 -55
  101. package/dist/providers/index.js +0 -7
  102. package/dist/providers/jina.js +0 -49
  103. package/dist/providers/router.js +0 -96
  104. package/dist/providers/search-provider.js +0 -32
  105. package/dist/providers/tavily.js +0 -54
  106. package/dist/quip/desktop-session.js +0 -317
  107. package/dist/registry/index.js +0 -1
  108. package/dist/registry/registry.js +0 -756
  109. package/dist/runtime-socket-local-control-client.js +0 -330
  110. package/dist/security/dns-normalization.js +0 -19
  111. package/dist/security/dns-pinning.js +0 -123
  112. package/dist/security/external-content.js +0 -91
  113. package/dist/security/ssrf.js +0 -181
  114. package/dist/slack/desktop-session.js +0 -324
  115. package/dist/tool-factory.js +0 -47
  116. package/dist/types.js +0 -7
  117. package/dist/utils/retry.js +0 -132
  118. package/dist/utils/safe-parse-json.js +0 -160
  119. package/dist/utils/url.js +0 -19
  120. package/dist-cjs/.tsbuildinfo +0 -1
  121. package/dist-cjs/ask-user-interaction.js +0 -27
  122. package/dist-cjs/cache/web-cache.js +0 -70
  123. package/dist-cjs/definitions/arion.js +0 -107
  124. package/dist-cjs/definitions/browser/browser.js +0 -421
  125. package/dist-cjs/definitions/browser/index.js +0 -8
  126. package/dist-cjs/definitions/browser/pw-downloads.js +0 -117
  127. package/dist-cjs/definitions/browser/pw-interactions.js +0 -213
  128. package/dist-cjs/definitions/browser/pw-responses.js +0 -84
  129. package/dist-cjs/definitions/browser/pw-session.js +0 -326
  130. package/dist-cjs/definitions/browser/pw-shared.js +0 -72
  131. package/dist-cjs/definitions/browser/pw-snapshot.js +0 -307
  132. package/dist-cjs/definitions/browser/pw-state.js +0 -70
  133. package/dist-cjs/definitions/browser/types.js +0 -5
  134. package/dist-cjs/definitions/code-intelligence.js +0 -473
  135. package/dist-cjs/definitions/core.js +0 -133
  136. package/dist-cjs/definitions/delegation.js +0 -515
  137. package/dist-cjs/definitions/deploy.js +0 -68
  138. package/dist-cjs/definitions/filesystem.js +0 -199
  139. package/dist-cjs/definitions/frg.js +0 -66
  140. package/dist-cjs/definitions/index.js +0 -43
  141. package/dist-cjs/definitions/memory.js +0 -126
  142. package/dist-cjs/definitions/messaging.js +0 -631
  143. package/dist-cjs/definitions/meta.js +0 -352
  144. package/dist-cjs/definitions/network.js +0 -162
  145. package/dist-cjs/definitions/outlook.js +0 -280
  146. package/dist-cjs/definitions/patch/apply-patch.js +0 -191
  147. package/dist-cjs/definitions/patch/fuzzy-match.js +0 -172
  148. package/dist-cjs/definitions/patch/index.js +0 -5
  149. package/dist-cjs/definitions/patch/patch-parser.js +0 -215
  150. package/dist-cjs/definitions/patch/sandbox-paths.js +0 -113
  151. package/dist-cjs/definitions/process/index.js +0 -8
  152. package/dist-cjs/definitions/process/process-registry.js +0 -231
  153. package/dist-cjs/definitions/process/process.js +0 -389
  154. package/dist-cjs/definitions/process/pty-keys.js +0 -259
  155. package/dist-cjs/definitions/process/session-slug.js +0 -145
  156. package/dist-cjs/definitions/quip.js +0 -198
  157. package/dist-cjs/definitions/search.js +0 -63
  158. package/dist-cjs/definitions/session-history.js +0 -72
  159. package/dist-cjs/definitions/shell.js +0 -184
  160. package/dist-cjs/definitions/slack.js +0 -183
  161. package/dist-cjs/definitions/web.js +0 -112
  162. package/dist-cjs/executors/apply-patch.js +0 -938
  163. package/dist-cjs/executors/arion.js +0 -125
  164. package/dist-cjs/executors/code-intelligence.js +0 -925
  165. package/dist-cjs/executors/deploy.js +0 -869
  166. package/dist-cjs/executors/filesystem.js +0 -1167
  167. package/dist-cjs/executors/frg-freshness.js +0 -627
  168. package/dist-cjs/executors/frg.js +0 -334
  169. package/dist-cjs/executors/index.js +0 -143
  170. package/dist-cjs/executors/learning-meta.js +0 -1165
  171. package/dist-cjs/executors/lsp-client.js +0 -310
  172. package/dist-cjs/executors/memory.js +0 -796
  173. package/dist-cjs/executors/meta.js +0 -226
  174. package/dist-cjs/executors/process-registry.js +0 -469
  175. package/dist-cjs/executors/pty-session-store.js +0 -34
  176. package/dist-cjs/executors/pty.js +0 -312
  177. package/dist-cjs/executors/restart.js +0 -155
  178. package/dist-cjs/executors/search-freshness.js +0 -234
  179. package/dist-cjs/executors/search-types.js +0 -56
  180. package/dist-cjs/executors/search.js +0 -102
  181. package/dist-cjs/executors/self-diagnose.js +0 -434
  182. package/dist-cjs/executors/session-history.js +0 -320
  183. package/dist-cjs/executors/shell-safety.js +0 -478
  184. package/dist-cjs/executors/shell.js +0 -1001
  185. package/dist-cjs/executors/utils.js +0 -73
  186. package/dist-cjs/executors/web.js +0 -547
  187. package/dist-cjs/extraction/content-extraction.js +0 -243
  188. package/dist-cjs/extraction/index.js +0 -8
  189. package/dist-cjs/headless-control-contract.js +0 -972
  190. package/dist-cjs/local-control-http-auth.js +0 -5
  191. package/dist-cjs/mcp/client.js +0 -185
  192. package/dist-cjs/mcp/connection.js +0 -484
  193. package/dist-cjs/mcp/index.js +0 -30
  194. package/dist-cjs/mcp/jsonrpc.js +0 -148
  195. package/dist-cjs/mcp/types.js +0 -8
  196. package/dist-cjs/network-control-adapter.js +0 -77
  197. package/dist-cjs/network-runtime/address-types.js +0 -168
  198. package/dist-cjs/network-runtime/db-owner-fencing.js +0 -76
  199. package/dist-cjs/network-runtime/delivery-receipts.js +0 -276
  200. package/dist-cjs/network-runtime/direct-endpoint-authority.js +0 -29
  201. package/dist-cjs/network-runtime/local-control-contract.js +0 -633
  202. package/dist-cjs/network-runtime/node-store-contract.js +0 -38
  203. package/dist-cjs/network-runtime/pair-route-contract.js +0 -80
  204. package/dist-cjs/network-runtime/peer-capabilities.js +0 -37
  205. package/dist-cjs/network-runtime/peer-principal-ref.js +0 -15
  206. package/dist-cjs/network-runtime/peer-state-machine.js +0 -129
  207. package/dist-cjs/network-runtime/protocol-schemas.js +0 -212
  208. package/dist-cjs/network-runtime/runtime-bootstrap-contract.js +0 -63
  209. package/dist-cjs/outlook/desktop-session.js +0 -318
  210. package/dist-cjs/policy.js +0 -155
  211. package/dist-cjs/providers/brave.js +0 -66
  212. package/dist-cjs/providers/duckduckgo.js +0 -180
  213. package/dist-cjs/providers/exa.js +0 -67
  214. package/dist-cjs/providers/firecrawl.js +0 -59
  215. package/dist-cjs/providers/index.js +0 -17
  216. package/dist-cjs/providers/jina.js +0 -53
  217. package/dist-cjs/providers/router.js +0 -100
  218. package/dist-cjs/providers/search-provider.js +0 -36
  219. package/dist-cjs/providers/tavily.js +0 -58
  220. package/dist-cjs/quip/desktop-session.js +0 -353
  221. package/dist-cjs/registry/index.js +0 -6
  222. package/dist-cjs/registry/registry.js +0 -761
  223. package/dist-cjs/runtime-socket-local-control-client.js +0 -367
  224. package/dist-cjs/security/dns-normalization.js +0 -22
  225. package/dist-cjs/security/dns-pinning.js +0 -160
  226. package/dist-cjs/security/external-content.js +0 -95
  227. package/dist-cjs/security/ssrf.js +0 -221
  228. package/dist-cjs/slack/desktop-session.js +0 -366
  229. package/dist-cjs/tool-factory.js +0 -50
  230. package/dist-cjs/types.js +0 -8
  231. package/dist-cjs/utils/retry.js +0 -169
  232. package/dist-cjs/utils/safe-parse-json.js +0 -164
  233. package/dist-cjs/utils/url.js +0 -23
@@ -1,144 +0,0 @@
1
- /**
2
- * JSON-RPC 2.0 Client for MCP
3
- *
4
- * Handles newline-delimited JSON over stdio streams.
5
- */
6
- import { EventEmitter } from "events";
7
- import { randomUUID } from "crypto";
8
- export class JSONRPCClient extends EventEmitter {
9
- stdin;
10
- stdout;
11
- pending = new Map();
12
- buffer = "";
13
- requestTimeout;
14
- constructor(options = {}) {
15
- super();
16
- this.requestTimeout = options.timeout ?? 30000;
17
- }
18
- /**
19
- * Connect to a process via stdio streams
20
- */
21
- connect(stdin, stdout) {
22
- this.stdin = stdin;
23
- this.stdout = stdout;
24
- stdout.on("data", (chunk) => {
25
- this.buffer += chunk.toString();
26
- this.processBuffer();
27
- });
28
- stdout.on("error", (error) => {
29
- this.emit("error", error);
30
- });
31
- stdout.on("end", () => {
32
- this.emit("close");
33
- });
34
- }
35
- processBuffer() {
36
- let newlineIdx;
37
- while ((newlineIdx = this.buffer.indexOf("\n")) !== -1) {
38
- const line = this.buffer.slice(0, newlineIdx).trim();
39
- this.buffer = this.buffer.slice(newlineIdx + 1);
40
- if (line) {
41
- try {
42
- this.handleMessage(JSON.parse(line));
43
- }
44
- catch (e) {
45
- this.emit("error", new Error(`Invalid JSON: ${line}`));
46
- }
47
- }
48
- }
49
- }
50
- handleMessage(msg) {
51
- // Ignore messages that aren't valid JSON-RPC 2.0
52
- if (typeof msg !== "object" ||
53
- msg === null ||
54
- !("jsonrpc" in msg) ||
55
- msg.jsonrpc !== "2.0")
56
- return;
57
- const rpcMsg = msg;
58
- // Response to our request
59
- if ("id" in rpcMsg && rpcMsg.id !== undefined) {
60
- const response = rpcMsg;
61
- const pending = this.pending.get(String(response.id));
62
- if (pending) {
63
- this.pending.delete(String(response.id));
64
- clearTimeout(pending.timeout);
65
- if (response.error) {
66
- pending.reject(new Error(`${response.error.code}: ${response.error.message}`));
67
- }
68
- else {
69
- pending.resolve(response.result);
70
- }
71
- }
72
- return;
73
- }
74
- // Notification from server
75
- if ("method" in rpcMsg) {
76
- const notification = rpcMsg;
77
- this.emit(notification.method, notification.params);
78
- this.emit("notification", {
79
- method: notification.method,
80
- params: notification.params,
81
- });
82
- }
83
- }
84
- /**
85
- * Send a request and wait for response
86
- */
87
- async request(method, params) {
88
- if (!this.stdin) {
89
- throw new Error("Not connected");
90
- }
91
- const id = randomUUID();
92
- const message = {
93
- jsonrpc: "2.0",
94
- id,
95
- method,
96
- params,
97
- };
98
- return new Promise((resolve, reject) => {
99
- const timeout = setTimeout(() => {
100
- if (this.pending.has(id)) {
101
- this.pending.delete(id);
102
- reject(new Error(`Request timeout: ${method}`));
103
- }
104
- }, this.requestTimeout);
105
- this.pending.set(id, {
106
- resolve: resolve,
107
- reject,
108
- timeout,
109
- });
110
- this.send(message);
111
- });
112
- }
113
- /**
114
- * Send a notification (no response expected)
115
- */
116
- notify(method, params) {
117
- const message = {
118
- jsonrpc: "2.0",
119
- method,
120
- params,
121
- };
122
- this.send(message);
123
- }
124
- send(message) {
125
- if (!this.stdin) {
126
- throw new Error("Not connected");
127
- }
128
- this.stdin.write(JSON.stringify(message) + "\n");
129
- }
130
- /**
131
- * Close and cleanup
132
- */
133
- close() {
134
- for (const [, pending] of this.pending) {
135
- clearTimeout(pending.timeout);
136
- pending.reject(new Error("Connection closed"));
137
- }
138
- this.pending.clear();
139
- this.buffer = "";
140
- this.stdin = undefined;
141
- this.stdout?.removeAllListeners();
142
- this.stdout = undefined;
143
- }
144
- }
package/dist/mcp/types.js DELETED
@@ -1,7 +0,0 @@
1
- /**
2
- * MCP (Model Context Protocol) Types
3
- *
4
- * Protocol version: 2024-11-05
5
- * https://modelcontextprotocol.io
6
- */
7
- export {};
@@ -1,72 +0,0 @@
1
- import { SigningPublicKeySchema } from "./network-runtime/index.js";
2
- export function toNetworkPeerView(peer) {
3
- const parsedSigningPublicKey = SigningPublicKeySchema.safeParse(peer.signingPublicKey?.trim());
4
- if (!parsedSigningPublicKey.success ||
5
- typeof peer.nodeId !== "string" ||
6
- peer.nodeId.length === 0) {
7
- return null;
8
- }
9
- const signingPublicKey = parsedSigningPublicKey.data;
10
- return {
11
- nodeId: peer.nodeId,
12
- transportPublicKey: peer.publicKey,
13
- displayNameSnapshot: peer.name,
14
- endpointHost: peer.endpointHost,
15
- endpointPort: peer.endpointPort,
16
- controlEndpoint: peer.controlEndpoint ?? null,
17
- signingPublicKey,
18
- status: peer.status,
19
- membershipStatus: peer.membershipStatus ?? peer.status,
20
- routeOwnership: peer.routeOwnership,
21
- routeOwnerNodeId: peer.routeOwnerNodeId ?? null,
22
- sessionState: peer.sessionState,
23
- deliveryReadiness: peer.deliveryReadiness,
24
- lastHandshake: peer.lastHandshake,
25
- createdAt: peer.createdAt,
26
- endpointRevision: peer.endpointRevision ?? 0,
27
- updatedAt: peer.updatedAt ?? peer.createdAt,
28
- };
29
- }
30
- export function toNetworkStatusView(status) {
31
- const parsedSigningPublicKey = SigningPublicKeySchema.safeParse(status.signingPublicKey?.trim());
32
- const signingPublicKey = parsedSigningPublicKey.success
33
- ? parsedSigningPublicKey.data
34
- : null;
35
- return {
36
- configured: status.configured,
37
- nodeId: status.nodeId,
38
- principalFingerprint: status.principalFingerprint,
39
- transportPublicKey: status.publicKey,
40
- listenPort: status.listenPort,
41
- externalEndpoint: status.externalEndpoint,
42
- activePeers: status.activePeers,
43
- totalPeers: status.totalPeers,
44
- connectedPeers: status.connectedPeers,
45
- handshakingPeers: status.handshakingPeers,
46
- queueOnlyPeers: status.queueOnlyPeers,
47
- supersededPeers: status.supersededPeers,
48
- signingPublicKey,
49
- };
50
- }
51
- export function toNetworkControlRef(networkManager) {
52
- if (!networkManager) {
53
- return undefined;
54
- }
55
- return {
56
- invite(displayName, options) {
57
- return networkManager.invite(displayName, options);
58
- },
59
- revokePeer(nodeId) {
60
- return networkManager.revokePeer(nodeId);
61
- },
62
- listPeers() {
63
- return networkManager.listPeers().flatMap((peer) => {
64
- const projected = toNetworkPeerView(peer);
65
- return projected ? [projected] : [];
66
- });
67
- },
68
- status() {
69
- return toNetworkStatusView(networkManager.status());
70
- },
71
- };
72
- }
@@ -1,165 +0,0 @@
1
- import { z } from "zod";
2
- const NonEmptyStringSchema = z.string().trim().min(1);
3
- /**
4
- * Stable durable identity for a node.
5
- * Semantic rules are enforced by the runtime cutover plan; the contract layer
6
- * starts by making the shape canonical everywhere.
7
- */
8
- export const NodeIdSchema = NonEmptyStringSchema.brand();
9
- /** One boot of a given node runtime. */
10
- export const RuntimeIdSchema = NonEmptyStringSchema.brand();
11
- export const NodeMetadataSchema = z.object({
12
- nodeId: NodeIdSchema,
13
- createdAt: NonEmptyStringSchema,
14
- schemaVersion: z.number().int().positive(),
15
- migratedFromLegacy: z.boolean(),
16
- });
17
- /** Monotonic publication revision for externally visible runtime advertisements. */
18
- export const PublicationRevisionSchema = z.number().int().nonnegative();
19
- /** Monotonic endpoint revision for register/discovery refreshes. */
20
- export const EndpointRevisionSchema = z.number().int().nonnegative();
21
- /** Monotonic generation for peer-binding continuity transitions. */
22
- export const BindingGenerationSchema = z.number().int().nonnegative();
23
- /** Monotonic generation for revocation precedence and continuity conflict checks. */
24
- export const RevocationGenerationSchema = z.number().int().nonnegative();
25
- /** How a local operator confirmed a revocation decision. */
26
- export const RevocationOperatorConfirmationSchema = z.enum([
27
- "local_operator_confirmed",
28
- "remote_capability_authenticated",
29
- ]);
30
- /** Structured local authority record for a peer revocation decision. */
31
- export const RevocationDecisionSchema = z.object({
32
- localNodeId: NodeIdSchema,
33
- targetNodeId: NodeIdSchema,
34
- revocationGeneration: RevocationGenerationSchema,
35
- operatorConfirmation: RevocationOperatorConfirmationSchema,
36
- });
37
- /** Monotonic owner generation for runtime ownership records. */
38
- export const OwnerGenerationSchema = z.number().int().positive();
39
- /** Monotonic revision for durable delivery lifecycle state transitions. */
40
- export const DeliveryLifecycleRevisionSchema = z.number().int().nonnegative();
41
- export const RuntimeOwnerRecordSchema = z
42
- .object({
43
- schemaVersion: z.number().int().positive(),
44
- nodeId: NodeIdSchema,
45
- ariaHome: NonEmptyStringSchema,
46
- runtimePid: z.number().int().positive(),
47
- runtimeId: RuntimeIdSchema,
48
- displayNameSnapshot: NonEmptyStringSchema.optional(),
49
- runtimeSocket: NonEmptyStringSchema,
50
- startedAt: NonEmptyStringSchema,
51
- lastHeartbeat: NonEmptyStringSchema,
52
- ownerGeneration: OwnerGenerationSchema,
53
- })
54
- .strict();
55
- /** One attached local client of the runtime. */
56
- export const ClientIdSchema = NonEmptyStringSchema.brand();
57
- /** Durable principal fingerprint (SHA-256 hex of signing public key DER). Signing-key evidence only. */
58
- export const PrincipalFingerprintSchema = NonEmptyStringSchema.brand();
59
- /** Transport public key / transport identity for a peer. */
60
- export const PeerTransportIdSchema = NonEmptyStringSchema.brand();
61
- /** TLS CA certificate fingerprint (SHA-256 hex of CA cert DER). Certificate-authority evidence only — distinct from signing-key evidence. */
62
- export const TlsCaFingerprintSchema = NonEmptyStringSchema.brand();
63
- /** Local-only loopback TLS SAN identity used for same-machine control attachment. */
64
- export const LoopbackTlsIdentitySchema = NonEmptyStringSchema.brand();
65
- /** Base64-encoded signing public key material crossing runtime/shared boundaries. */
66
- export const SigningPublicKeySchema = NonEmptyStringSchema.brand();
67
- /** Explicit network transport endpoint advertisement. */
68
- export const TransportEndpointAdvertisementSchema = z.object({
69
- host: NonEmptyStringSchema,
70
- port: z.number().int().min(1).max(65535),
71
- });
72
- /**
73
- * Runtime-owned local inbox addressing.
74
- * Same-machine clients are local attachments, not mesh peers.
75
- */
76
- export const InboxAddressSchema = z.discriminatedUnion("kind", [
77
- z.object({
78
- kind: z.literal("node"),
79
- nodeId: NodeIdSchema,
80
- }),
81
- z.object({
82
- kind: z.literal("client"),
83
- clientId: ClientIdSchema,
84
- }),
85
- ]);
86
- /**
87
- * Public control-plane endpoint advertisement used by peers for pinned,
88
- * mutating requests.
89
- */
90
- export const ControlEndpointAdvertisementSchema = z.object({
91
- host: NonEmptyStringSchema,
92
- port: z.number().int().min(1).max(65535),
93
- tlsCaFingerprint: TlsCaFingerprintSchema,
94
- tlsServerIdentity: PrincipalFingerprintSchema,
95
- protocolVersion: z.number().int().positive(),
96
- endpointRevision: EndpointRevisionSchema.optional(),
97
- });
98
- /**
99
- * Remote/public node advertisement. This deliberately excludes local-only
100
- * runtime/session identity like RuntimeId.
101
- */
102
- export const NodeAdvertisementSchema = z.object({
103
- nodeId: NodeIdSchema,
104
- principalFingerprint: PrincipalFingerprintSchema,
105
- transportPublicKey: PeerTransportIdSchema,
106
- publicationRevision: PublicationRevisionSchema.optional(),
107
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
108
- displayNameSnapshot: NonEmptyStringSchema.optional(),
109
- });
110
- /**
111
- * Local-only runtime registry summary. This is not a remote/public mesh
112
- * contract and may include RuntimeId.
113
- */
114
- export const LocalRuntimeSummarySchema = z.object({
115
- nodeId: NodeIdSchema,
116
- runtimeId: RuntimeIdSchema,
117
- lastHeartbeat: NonEmptyStringSchema.optional(),
118
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
119
- displayNameSnapshot: NonEmptyStringSchema.optional(),
120
- });
121
- // ── Durable Delivery Handle ────────────────────────────────────────
122
- /**
123
- * Branded operation handle for durable delivery.
124
- * Produced ONLY by `submitDurable()` — the caller never mints handles.
125
- */
126
- export const DurableDeliveryHandleSchema = NonEmptyStringSchema.brand();
127
- /**
128
- * Terminal status types for a durable delivery operation.
129
- */
130
- export const DurableDeliveryResultSchema = z.discriminatedUnion("status", [
131
- z.object({
132
- status: z.literal("pending"),
133
- queuedAt: z.string(),
134
- nextAttemptAt: z.string().optional(),
135
- attemptCount: z.number(),
136
- }),
137
- z.object({
138
- status: z.literal("delivered"),
139
- deliveredAt: z.string(),
140
- }),
141
- z.object({
142
- status: z.literal("expired"),
143
- reason: z.literal("ttl_exceeded"),
144
- queuedAt: z.string(),
145
- expiredAt: z.string(),
146
- }),
147
- z.object({
148
- status: z.literal("rejected"),
149
- reason: z.enum(["recipient_revoked", "recipient_unknown", "envelope_invalid"]),
150
- }),
151
- ]);
152
- /**
153
- * Submit result — returned immediately from `submitDurable()`.
154
- */
155
- export const DurableSubmitResultSchema = z.discriminatedUnion("status", [
156
- z.object({
157
- status: z.literal("accepted"),
158
- operationId: DurableDeliveryHandleSchema,
159
- queuedAt: z.string(),
160
- }),
161
- z.object({
162
- status: z.literal("rejected"),
163
- reason: z.enum(["recipient_revoked", "recipient_unknown", "envelope_invalid"]),
164
- }),
165
- ]);
@@ -1,69 +0,0 @@
1
- /**
2
- * Shared database-level ownership fencing for runtime-owned durable stores.
3
- *
4
- * All stores backed by the same SQLite database share one `owner_epoch` table.
5
- * The runtime claims the epoch once at startup. Each store's write methods
6
- * call `assertDbOwnership()` before durable mutations.
7
- *
8
- * A zombie runtime whose generation is stale gets StaleOwnerError on
9
- * its next write — no external kill needed.
10
- */
11
- export class StaleOwnerError extends Error {
12
- kind = "StaleOwnerError";
13
- claimedGeneration;
14
- currentGeneration;
15
- constructor(claimed, current) {
16
- super(`StaleOwnerError: runtime claims generation ${claimed} but store is at generation ${current}. ` +
17
- `This runtime has been superseded and must shut down immediately.`);
18
- this.name = "StaleOwnerError";
19
- this.claimedGeneration = claimed;
20
- this.currentGeneration = current;
21
- }
22
- }
23
- /**
24
- * Ensure the owner_epoch table exists in the given database.
25
- * Safe to call multiple times (idempotent).
26
- */
27
- export function ensureOwnerEpochTable(db) {
28
- db.exec(`
29
- CREATE TABLE IF NOT EXISTS owner_epoch (
30
- scope TEXT PRIMARY KEY DEFAULT 'runtime',
31
- owner_generation INTEGER NOT NULL
32
- )
33
- `);
34
- }
35
- /**
36
- * Atomically claim the owner epoch for this runtime.
37
- * Throws StaleOwnerError if a newer generation already owns the database.
38
- */
39
- export function claimDbOwnerEpoch(db, generation) {
40
- ensureOwnerEpochTable(db);
41
- const result = db
42
- .prepare(`INSERT INTO owner_epoch (scope, owner_generation) VALUES ('runtime', ?)
43
- ON CONFLICT(scope) DO UPDATE SET owner_generation = excluded.owner_generation
44
- WHERE excluded.owner_generation > owner_epoch.owner_generation`)
45
- .run(generation);
46
- if (result.changes === 0) {
47
- const row = db
48
- .prepare("SELECT owner_generation FROM owner_epoch WHERE scope = 'runtime'")
49
- .get();
50
- const current = row?.owner_generation ?? 0;
51
- if (current > generation) {
52
- throw new StaleOwnerError(generation, current);
53
- }
54
- }
55
- }
56
- /**
57
- * Assert the calling runtime is still the current owner of this database.
58
- * Must be called inside the same SQLite transaction as the write.
59
- * Throws StaleOwnerError if superseded.
60
- */
61
- export function assertDbOwnership(db, generation) {
62
- const row = db
63
- .prepare("SELECT owner_generation FROM owner_epoch WHERE scope = 'runtime'")
64
- .get();
65
- const current = row?.owner_generation ?? 0;
66
- if (current > generation) {
67
- throw new StaleOwnerError(generation, current);
68
- }
69
- }