@aria-cli/tools 1.0.9 → 1.0.11

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 (241) hide show
  1. package/package.json +9 -5
  2. package/src/__tests__/web-fetch-download.test.ts +0 -433
  3. package/src/__tests__/web-tools.test.ts +0 -619
  4. package/src/ask-user-interaction.ts +0 -33
  5. package/src/cache/web-cache.ts +0 -110
  6. package/src/definitions/arion.ts +0 -118
  7. package/src/definitions/browser/browser.ts +0 -502
  8. package/src/definitions/browser/index.ts +0 -5
  9. package/src/definitions/browser/pw-downloads.ts +0 -142
  10. package/src/definitions/browser/pw-interactions.ts +0 -282
  11. package/src/definitions/browser/pw-responses.ts +0 -98
  12. package/src/definitions/browser/pw-session.ts +0 -405
  13. package/src/definitions/browser/pw-shared.ts +0 -85
  14. package/src/definitions/browser/pw-snapshot.ts +0 -383
  15. package/src/definitions/browser/pw-state.ts +0 -101
  16. package/src/definitions/browser/types.ts +0 -203
  17. package/src/definitions/code-intelligence.ts +0 -526
  18. package/src/definitions/core.ts +0 -118
  19. package/src/definitions/delegation.ts +0 -567
  20. package/src/definitions/deploy.ts +0 -73
  21. package/src/definitions/filesystem.ts +0 -217
  22. package/src/definitions/frg.ts +0 -67
  23. package/src/definitions/index.ts +0 -28
  24. package/src/definitions/memory.ts +0 -150
  25. package/src/definitions/messaging.ts +0 -734
  26. package/src/definitions/meta.ts +0 -392
  27. package/src/definitions/network.ts +0 -179
  28. package/src/definitions/outlook.ts +0 -318
  29. package/src/definitions/patch/apply-patch.ts +0 -235
  30. package/src/definitions/patch/fuzzy-match.ts +0 -217
  31. package/src/definitions/patch/index.ts +0 -1
  32. package/src/definitions/patch/patch-parser.ts +0 -297
  33. package/src/definitions/patch/sandbox-paths.ts +0 -129
  34. package/src/definitions/process/index.ts +0 -5
  35. package/src/definitions/process/process-registry.ts +0 -303
  36. package/src/definitions/process/process.ts +0 -456
  37. package/src/definitions/process/pty-keys.ts +0 -298
  38. package/src/definitions/process/session-slug.ts +0 -147
  39. package/src/definitions/quip.ts +0 -225
  40. package/src/definitions/search.ts +0 -67
  41. package/src/definitions/session-history.ts +0 -79
  42. package/src/definitions/shell.ts +0 -202
  43. package/src/definitions/slack.ts +0 -211
  44. package/src/definitions/web.ts +0 -119
  45. package/src/executors/apply-patch.ts +0 -1035
  46. package/src/executors/arion.ts +0 -199
  47. package/src/executors/code-intelligence.ts +0 -1179
  48. package/src/executors/deploy.ts +0 -1066
  49. package/src/executors/filesystem.ts +0 -1428
  50. package/src/executors/frg-freshness.ts +0 -743
  51. package/src/executors/frg.ts +0 -394
  52. package/src/executors/index.ts +0 -280
  53. package/src/executors/learning-meta.ts +0 -1367
  54. package/src/executors/lsp-client.ts +0 -355
  55. package/src/executors/memory.ts +0 -978
  56. package/src/executors/meta.ts +0 -293
  57. package/src/executors/process-registry.ts +0 -570
  58. package/src/executors/pty-session-store.ts +0 -43
  59. package/src/executors/pty.ts +0 -342
  60. package/src/executors/restart.ts +0 -133
  61. package/src/executors/search-freshness.ts +0 -249
  62. package/src/executors/search-types.ts +0 -98
  63. package/src/executors/search.ts +0 -89
  64. package/src/executors/self-diagnose.ts +0 -552
  65. package/src/executors/session-history.ts +0 -435
  66. package/src/executors/shell-safety.ts +0 -519
  67. package/src/executors/shell.ts +0 -1243
  68. package/src/executors/utils.ts +0 -40
  69. package/src/executors/web.ts +0 -786
  70. package/src/extraction/content-extraction.ts +0 -281
  71. package/src/extraction/index.ts +0 -5
  72. package/src/headless-control-contract.ts +0 -1149
  73. package/src/index.ts +0 -788
  74. package/src/local-control-http-auth.ts +0 -2
  75. package/src/mcp/client.ts +0 -218
  76. package/src/mcp/connection.ts +0 -568
  77. package/src/mcp/index.ts +0 -11
  78. package/src/mcp/jsonrpc.ts +0 -195
  79. package/src/mcp/types.ts +0 -199
  80. package/src/network-control-adapter.ts +0 -88
  81. package/src/network-runtime/address-types.ts +0 -218
  82. package/src/network-runtime/db-owner-fencing.ts +0 -91
  83. package/src/network-runtime/delivery-receipts.ts +0 -372
  84. package/src/network-runtime/direct-endpoint-authority.ts +0 -35
  85. package/src/network-runtime/index.ts +0 -316
  86. package/src/network-runtime/local-control-contract.ts +0 -784
  87. package/src/network-runtime/node-store-contract.ts +0 -46
  88. package/src/network-runtime/pair-route-contract.ts +0 -97
  89. package/src/network-runtime/peer-capabilities.ts +0 -48
  90. package/src/network-runtime/peer-principal-ref.ts +0 -20
  91. package/src/network-runtime/peer-state-machine.ts +0 -160
  92. package/src/network-runtime/protocol-schemas.ts +0 -265
  93. package/src/network-runtime/runtime-bootstrap-contract.ts +0 -83
  94. package/src/outlook/desktop-session.ts +0 -409
  95. package/src/policy.ts +0 -171
  96. package/src/providers/brave.ts +0 -80
  97. package/src/providers/duckduckgo.ts +0 -199
  98. package/src/providers/exa.ts +0 -85
  99. package/src/providers/firecrawl.ts +0 -77
  100. package/src/providers/index.ts +0 -8
  101. package/src/providers/jina.ts +0 -70
  102. package/src/providers/router.ts +0 -121
  103. package/src/providers/search-provider.ts +0 -74
  104. package/src/providers/tavily.ts +0 -74
  105. package/src/quip/desktop-session.ts +0 -435
  106. package/src/registry/index.ts +0 -1
  107. package/src/registry/registry.ts +0 -905
  108. package/src/runtime-socket-local-control-client.ts +0 -632
  109. package/src/security/dns-normalization.ts +0 -34
  110. package/src/security/dns-pinning.ts +0 -138
  111. package/src/security/external-content.ts +0 -129
  112. package/src/security/ssrf.ts +0 -207
  113. package/src/slack/desktop-session.ts +0 -493
  114. package/src/tool-factory.ts +0 -91
  115. package/src/types.ts +0 -1341
  116. package/src/utils/retry.ts +0 -163
  117. package/src/utils/safe-parse-json.ts +0 -176
  118. package/src/utils/url.ts +0 -20
  119. package/tests/benchmarks/registry.bench.ts +0 -57
  120. package/tests/cache/web-cache.test.ts +0 -147
  121. package/tests/critical-integration.test.ts +0 -1465
  122. package/tests/definitions/apply-patch.test.ts +0 -586
  123. package/tests/definitions/browser.test.ts +0 -495
  124. package/tests/definitions/delegation-pause-resume.test.ts +0 -758
  125. package/tests/definitions/execution.test.ts +0 -671
  126. package/tests/definitions/messaging-inbox-scope.test.ts +0 -229
  127. package/tests/definitions/messaging.test.ts +0 -1468
  128. package/tests/definitions/outlook.test.ts +0 -30
  129. package/tests/definitions/process.test.ts +0 -469
  130. package/tests/definitions/slack.test.ts +0 -28
  131. package/tests/definitions/tool-inventory.test.ts +0 -218
  132. package/tests/e2e/delegation-quest-orchestration.e2e.test.ts +0 -433
  133. package/tests/e2e/memory-tool-discovery-contract.e2e.test.ts +0 -81
  134. package/tests/executors/apply-patch.test.ts +0 -538
  135. package/tests/executors/arion.test.ts +0 -309
  136. package/tests/executors/conversation-primitives.test.ts +0 -250
  137. package/tests/executors/deploy.test.ts +0 -746
  138. package/tests/executors/filesystem-tools.test.ts +0 -357
  139. package/tests/executors/filesystem.test.ts +0 -959
  140. package/tests/executors/frg-freshness.test.ts +0 -136
  141. package/tests/executors/frg-merge.test.ts +0 -70
  142. package/tests/executors/frg-session-content.test.ts +0 -40
  143. package/tests/executors/frg.test.ts +0 -56
  144. package/tests/executors/memory-bugfixes.test.ts +0 -257
  145. package/tests/executors/memory-real-memoria.integration.test.ts +0 -316
  146. package/tests/executors/memory.test.ts +0 -853
  147. package/tests/executors/meta-tools.test.ts +0 -411
  148. package/tests/executors/meta.test.ts +0 -683
  149. package/tests/executors/path-containment.test.ts +0 -51
  150. package/tests/executors/process-registry.test.ts +0 -505
  151. package/tests/executors/pty.test.ts +0 -664
  152. package/tests/executors/quest-security.test.ts +0 -249
  153. package/tests/executors/read-file-media.test.ts +0 -230
  154. package/tests/executors/recall-knowledge-schema.test.ts +0 -209
  155. package/tests/executors/recall-tags.test.ts +0 -278
  156. package/tests/executors/remember-null-safety.contract.test.ts +0 -41
  157. package/tests/executors/restart.test.ts +0 -67
  158. package/tests/executors/search-unified.test.ts +0 -381
  159. package/tests/executors/session-history.test.ts +0 -340
  160. package/tests/executors/session-transcript.test.ts +0 -561
  161. package/tests/executors/shell-abort.test.ts +0 -416
  162. package/tests/executors/shell-env-blocklist.test.ts +0 -648
  163. package/tests/executors/shell-env-process.test.ts +0 -245
  164. package/tests/executors/shell-process-registry.test.ts +0 -334
  165. package/tests/executors/shell-tools.test.ts +0 -393
  166. package/tests/executors/shell.test.ts +0 -690
  167. package/tests/executors/web-abort-vs-timeout.test.ts +0 -213
  168. package/tests/executors/web-integration.test.ts +0 -633
  169. package/tests/executors/web-symlink.test.ts +0 -18
  170. package/tests/executors/web.test.ts +0 -1400
  171. package/tests/executors/write-stdin.test.ts +0 -145
  172. package/tests/extraction/content-extraction.test.ts +0 -153
  173. package/tests/guards/tools-default-test-lane.integration.test.ts +0 -21
  174. package/tests/guards/tools-package-test-commands.e2e.test.ts +0 -43
  175. package/tests/guards/tools-test-lane-manifest.contract.test.ts +0 -76
  176. package/tests/guards/tools-vitest-workspace-alias.contract.test.ts +0 -63
  177. package/tests/helpers/async-waits.ts +0 -53
  178. package/tests/integration/headless-control-contract.integration.test.ts +0 -153
  179. package/tests/integration/memory-tool-schema-parity.integration.test.ts +0 -67
  180. package/tests/integration/meta-tools-round-trip.integration.test.ts +0 -506
  181. package/tests/integration/quest-round-trip.test.ts +0 -303
  182. package/tests/integration/registry-executor-flow.test.ts +0 -85
  183. package/tests/integration.test.ts +0 -177
  184. package/tests/loading-tier.test.ts +0 -126
  185. package/tests/mcp/client-reconnect.test.ts +0 -267
  186. package/tests/mcp/connection.test.ts +0 -846
  187. package/tests/mcp/injectable-logger.test.ts +0 -83
  188. package/tests/mcp/jsonrpc.test.ts +0 -109
  189. package/tests/mcp/lifecycle.test.ts +0 -879
  190. package/tests/network-runtime/address-types.contract.test.ts +0 -143
  191. package/tests/network-runtime/continuity-bind-schema.contract.test.ts +0 -203
  192. package/tests/network-runtime/local-control-contract.test.ts +0 -869
  193. package/tests/network-runtime/local-control-invite-token.contract.test.ts +0 -146
  194. package/tests/network-runtime/node-store-contract.test.ts +0 -11
  195. package/tests/network-runtime/pair-protocol-nodeid.contract.test.ts +0 -15
  196. package/tests/network-runtime/peer-state-machine.contract.test.ts +0 -148
  197. package/tests/network-runtime/protocol-schemas.contract.test.ts +0 -512
  198. package/tests/network-runtime/relay-pending-nodeid.contract.test.ts +0 -62
  199. package/tests/network-runtime/runtime-bootstrap-contract.test.ts +0 -227
  200. package/tests/network-runtime/runtime-socket-local-control-client.test.ts +0 -621
  201. package/tests/network-runtime/wait-for-message-script.test.ts +0 -288
  202. package/tests/parallel.test.ts +0 -71
  203. package/tests/policy.test.ts +0 -184
  204. package/tests/print-default-test-lane.ts +0 -14
  205. package/tests/print-test-lane-manifest.ts +0 -22
  206. package/tests/providers/brave.test.ts +0 -159
  207. package/tests/providers/duckduckgo.test.ts +0 -207
  208. package/tests/providers/exa.test.ts +0 -175
  209. package/tests/providers/firecrawl.test.ts +0 -168
  210. package/tests/providers/jina.test.ts +0 -144
  211. package/tests/providers/router.test.ts +0 -328
  212. package/tests/providers/tavily.test.ts +0 -165
  213. package/tests/registry/discovery.test.ts +0 -154
  214. package/tests/registry/injectable-logger.test.ts +0 -230
  215. package/tests/registry/input-validation.test.ts +0 -361
  216. package/tests/registry/interface-completeness.test.ts +0 -85
  217. package/tests/registry/mcp-integration.test.ts +0 -103
  218. package/tests/registry/mcp-read-only-hint.test.ts +0 -60
  219. package/tests/registry/memoria-discovery.test.ts +0 -390
  220. package/tests/registry/nested-validation.test.ts +0 -283
  221. package/tests/registry/pseudo-tool-filtering.test.ts +0 -258
  222. package/tests/registry/registration-lifecycle.test.ts +0 -133
  223. package/tests/registry-validation.test.ts +0 -424
  224. package/tests/registry.test.ts +0 -460
  225. package/tests/security/dns-pinning.test.ts +0 -162
  226. package/tests/security/external-content.test.ts +0 -144
  227. package/tests/security/ssrf.test.ts +0 -118
  228. package/tests/shell-safety-integration.test.ts +0 -32
  229. package/tests/shell-safety.test.ts +0 -365
  230. package/tests/slack/desktop-session.test.ts +0 -50
  231. package/tests/test-lane-manifest.ts +0 -440
  232. package/tests/test-utils.ts +0 -27
  233. package/tests/tool-factory.test.ts +0 -188
  234. package/tests/utils/retry.test.ts +0 -231
  235. package/tests/utils/url.test.ts +0 -63
  236. package/tsconfig.cjs.json +0 -24
  237. package/tsconfig.json +0 -12
  238. package/vitest.config.ts +0 -55
  239. package/vitest.e2e.config.ts +0 -24
  240. package/vitest.integration.config.ts +0 -24
  241. package/vitest.native.config.ts +0 -24
@@ -1,46 +0,0 @@
1
- import { z } from "zod";
2
- import {
3
- NodeIdSchema,
4
- RuntimeIdSchema,
5
- RuntimeOwnerRecordSchema,
6
- type RuntimeOwnerRecord,
7
- } from "./address-types.js";
8
-
9
- const NonEmptyStringSchema = z.string().trim().min(1);
10
- const RecordSchema = z.record(z.string(), z.unknown());
11
-
12
- export { RuntimeOwnerRecordSchema } from "./address-types.js";
13
- export type { RuntimeOwnerRecord } from "./address-types.js";
14
-
15
- export const RuntimeEventKindSchema = z.enum([
16
- "client_attached",
17
- "client_detached",
18
- "runtime_started",
19
- "runtime_stopped",
20
- "runtime_stale",
21
- "runtime_restarted",
22
- "pair_proposed",
23
- "proof_committed",
24
- "continuity_bound",
25
- "revocation_committed",
26
- "ingress_accepted",
27
- "ingress_rejected",
28
- "durable_send_queued",
29
- "durable_send_dispatching",
30
- "durable_send_acked",
31
- "durable_send_expired",
32
- ]);
33
- export type RuntimeEventKind = z.infer<typeof RuntimeEventKindSchema>;
34
-
35
- export const RuntimeEventSchema = z
36
- .object({
37
- eventId: NonEmptyStringSchema,
38
- nodeId: NodeIdSchema,
39
- runtimeId: RuntimeIdSchema,
40
- kind: RuntimeEventKindSchema,
41
- revision: z.number().int().nonnegative().optional(),
42
- recordedAt: NonEmptyStringSchema,
43
- payload: RecordSchema,
44
- })
45
- .strict();
46
- export type RuntimeEvent = z.infer<typeof RuntimeEventSchema>;
@@ -1,97 +0,0 @@
1
- import { z } from "zod";
2
- import {
3
- ControlEndpointAdvertisementSchema,
4
- NodeIdSchema,
5
- PrincipalFingerprintSchema,
6
- SigningPublicKeySchema,
7
- TransportEndpointAdvertisementSchema,
8
- } from "./address-types.js";
9
- import { SignedContinuityBindSchema } from "./protocol-schemas.js";
10
-
11
- const NonEmptyStringSchema = z.string().trim().min(1);
12
-
13
- function toFastifyBodyJsonSchema(schema: z.ZodTypeAny): Record<string, unknown> {
14
- const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
15
- delete jsonSchema.$schema;
16
- return jsonSchema;
17
- }
18
-
19
- export const PairRequestRouteBodySchema = z
20
- .object({
21
- displayNameSnapshot: NonEmptyStringSchema,
22
- nodeId: NodeIdSchema,
23
- signingPublicKey: SigningPublicKeySchema,
24
- port: z.number().int().min(1).max(65535),
25
- ephemeralPublicKey: z.string().max(512),
26
- ephemeralKeySignature: z.string().max(512),
27
- caCert: z.string().max(4096).optional(),
28
- protocolVersion: z.number().min(1).max(100).optional(),
29
- wait: z.boolean().optional(),
30
- })
31
- .strict();
32
- export type PairRequestRouteBody = z.infer<typeof PairRequestRouteBodySchema>;
33
- export const PairRequestRouteBodyJsonSchema = toFastifyBodyJsonSchema(PairRequestRouteBodySchema);
34
-
35
- export const AcceptInviteRequestSchema = z
36
- .object({
37
- inviteToken: NonEmptyStringSchema,
38
- nodeId: NodeIdSchema,
39
- displayNameSnapshot: NonEmptyStringSchema.optional(),
40
- transportEndpoint: TransportEndpointAdvertisementSchema,
41
- controlEndpoint: ControlEndpointAdvertisementSchema,
42
- continuity: SignedContinuityBindSchema.optional(),
43
- })
44
- .strict();
45
- export type AcceptInviteRequest = z.infer<typeof AcceptInviteRequestSchema>;
46
- export const AcceptInviteRequestBodyJsonSchema = toFastifyBodyJsonSchema(AcceptInviteRequestSchema);
47
-
48
- export const PairRelayRouteBodySchema = z
49
- .object({
50
- targetNodeId: NodeIdSchema,
51
- displayNameSnapshot: NonEmptyStringSchema,
52
- nodeId: NodeIdSchema,
53
- signingPublicKey: SigningPublicKeySchema,
54
- port: z.number().int().min(1).max(65535),
55
- ephemeralPublicKey: z.string().max(512),
56
- ephemeralKeySignature: z.string().max(512),
57
- caCert: z.string().max(4096).optional(),
58
- })
59
- .strict();
60
- export type PairRelayRouteBody = z.infer<typeof PairRelayRouteBodySchema>;
61
- export const PairRelayRouteBodyJsonSchema = toFastifyBodyJsonSchema(PairRelayRouteBodySchema);
62
-
63
- export const RelayPendingQuerySchema = z
64
- .object({
65
- targetNodeId: NodeIdSchema,
66
- signingPublicKey: SigningPublicKeySchema,
67
- signature: NonEmptyStringSchema.max(512),
68
- timestamp: NonEmptyStringSchema.max(20),
69
- })
70
- .strict();
71
- export type RelayPendingQuery = z.infer<typeof RelayPendingQuerySchema>;
72
- export const RelayPendingQueryJsonSchema = toFastifyBodyJsonSchema(RelayPendingQuerySchema);
73
-
74
- export const RelayPendingRequestSchema = z
75
- .object({
76
- id: NonEmptyStringSchema,
77
- nodeId: NodeIdSchema,
78
- displayNameSnapshot: NonEmptyStringSchema.optional(),
79
- principalFingerprint: PrincipalFingerprintSchema,
80
- signingPublicKey: SigningPublicKeySchema,
81
- port: z.number().int().min(1).max(65535),
82
- ingressHost: NonEmptyStringSchema,
83
- responderControlHostHint: NonEmptyStringSchema.optional(),
84
- ephemeralPublicKey: z.string().max(512).optional(),
85
- ephemeralKeySignature: z.string().max(512).optional(),
86
- caCert: z.string().max(4096).optional(),
87
- expiresAt: z.number().int().nonnegative(),
88
- })
89
- .strict();
90
- export type RelayPendingRequest = z.infer<typeof RelayPendingRequestSchema>;
91
-
92
- export const RelayPendingResponseSchema = z
93
- .object({
94
- requests: RelayPendingRequestSchema.array(),
95
- })
96
- .strict();
97
- export type RelayPendingResponse = z.infer<typeof RelayPendingResponseSchema>;
@@ -1,48 +0,0 @@
1
- import type { PeerIdentityState, PeerTransportState } from "./peer-state-machine.js";
2
-
3
- export function canRecordPendingPair(identityState: PeerIdentityState): boolean {
4
- return identityState === "invited" || identityState === "joining";
5
- }
6
-
7
- export function canCommitVerifiedPair(
8
- identityState: PeerIdentityState,
9
- proof: { proofValid: boolean },
10
- ): boolean {
11
- return identityState === "paired_unverified" && proof.proofValid;
12
- }
13
-
14
- export function canRefreshEndpoint(identityState: PeerIdentityState): boolean {
15
- return (
16
- identityState === "joining" ||
17
- identityState === "paired_unverified" ||
18
- identityState === "verified"
19
- );
20
- }
21
-
22
- export function canHeartbeat(identityState: PeerIdentityState): boolean {
23
- return identityState === "paired_unverified" || identityState === "verified";
24
- }
25
-
26
- export function canAttemptBestEffortTransport(
27
- identityState: PeerIdentityState,
28
- transportState: PeerTransportState,
29
- ): boolean {
30
- if (identityState === "revoked") return false;
31
- return (
32
- transportState === "endpoint_known" ||
33
- transportState === "connecting" ||
34
- transportState === "connected" ||
35
- transportState === "degraded"
36
- );
37
- }
38
-
39
- export function canAttemptDurableDelivery(
40
- identityState: PeerIdentityState,
41
- transportState: PeerTransportState,
42
- ): boolean {
43
- return identityState === "verified" && transportState === "connected";
44
- }
45
-
46
- export function canMutateTrustedState(identityState: PeerIdentityState): boolean {
47
- return identityState === "verified";
48
- }
@@ -1,20 +0,0 @@
1
- import { z } from "zod";
2
- import {
3
- BindingGenerationSchema,
4
- NodeIdSchema,
5
- PrincipalFingerprintSchema,
6
- PeerTransportIdSchema,
7
- } from "./address-types.js";
8
-
9
- const NonEmptyStringSchema = z.string().trim().min(1);
10
-
11
- export const NodePrincipalBindingRefSchema = z
12
- .object({
13
- nodeId: NodeIdSchema,
14
- principalFingerprint: PrincipalFingerprintSchema,
15
- transportPublicKey: PeerTransportIdSchema,
16
- bindingGeneration: BindingGenerationSchema,
17
- displayNameSnapshot: NonEmptyStringSchema.optional(),
18
- })
19
- .strict();
20
- export type NodePrincipalBindingRef = z.infer<typeof NodePrincipalBindingRefSchema>;
@@ -1,160 +0,0 @@
1
- import { z } from "zod";
2
-
3
- export const LegacyPeerRegistryStatusSchema = z.enum([
4
- "active",
5
- "pending",
6
- "pending_tunnel",
7
- "pending_verification",
8
- "revoked",
9
- ]);
10
- export type LegacyPeerRegistryStatus = z.infer<typeof LegacyPeerRegistryStatusSchema>;
11
-
12
- export const PeerIdentityStateSchema = z.enum([
13
- "invited",
14
- "joining",
15
- "paired_unverified",
16
- "verified",
17
- "revoked",
18
- ]);
19
- export type PeerIdentityState = z.infer<typeof PeerIdentityStateSchema>;
20
-
21
- export const PeerTransportStateSchema = z.enum([
22
- "unknown",
23
- "endpoint_known",
24
- "connecting",
25
- "connected",
26
- "degraded",
27
- "disconnected",
28
- ]);
29
- export type PeerTransportState = z.infer<typeof PeerTransportStateSchema>;
30
-
31
- export const PeerMutationKindSchema = z.enum(["repair", "continuity", "revocation"]);
32
- export type PeerMutationKind = z.infer<typeof PeerMutationKindSchema>;
33
-
34
- export const LegacyPeerRuntimeShapeSchema = z.object({
35
- status: LegacyPeerRegistryStatusSchema,
36
- endpointHost: z.string().nullable().optional(),
37
- endpointPort: z.number().int().nullable().optional(),
38
- lastHandshake: z.number().int().nullable().optional(),
39
- });
40
- export type LegacyPeerRuntimeShape = z.infer<typeof LegacyPeerRuntimeShapeSchema>;
41
-
42
- const VALID_TRANSPORT_BY_IDENTITY: Record<PeerIdentityState, readonly PeerTransportState[]> = {
43
- invited: ["unknown", "endpoint_known"],
44
- joining: ["unknown", "endpoint_known", "connecting"],
45
- paired_unverified: [
46
- "unknown",
47
- "endpoint_known",
48
- "connecting",
49
- "connected",
50
- "degraded",
51
- "disconnected",
52
- ],
53
- verified: ["unknown", "endpoint_known", "connecting", "connected", "degraded", "disconnected"],
54
- revoked: ["unknown", "disconnected"],
55
- };
56
-
57
- export function isValidPeerStateCombination(
58
- identityState: PeerIdentityState,
59
- transportState: PeerTransportState,
60
- ): boolean {
61
- return VALID_TRANSPORT_BY_IDENTITY[identityState].includes(transportState);
62
- }
63
-
64
- export const PeerStateSnapshotSchema = z
65
- .object({
66
- identityState: PeerIdentityStateSchema,
67
- transportState: PeerTransportStateSchema,
68
- })
69
- .superRefine((value, ctx) => {
70
- if (!isValidPeerStateCombination(value.identityState, value.transportState)) {
71
- ctx.addIssue({
72
- code: z.ZodIssueCode.custom,
73
- message: `invalid peer state combination: ${value.identityState}/${value.transportState}`,
74
- });
75
- }
76
- });
77
- export type PeerStateSnapshot = z.infer<typeof PeerStateSnapshotSchema>;
78
-
79
- export function derivePeerStateFromLegacyStatus(input: LegacyPeerRuntimeShape): PeerStateSnapshot {
80
- const legacy = LegacyPeerRuntimeShapeSchema.parse(input);
81
- const hasEndpoint = Boolean(legacy.endpointHost && legacy.endpointPort);
82
- const hasHandshake =
83
- typeof legacy.lastHandshake === "number" &&
84
- Number.isFinite(legacy.lastHandshake) &&
85
- legacy.lastHandshake > 0;
86
-
87
- const identityState: PeerIdentityState =
88
- legacy.status === "pending"
89
- ? "invited"
90
- : legacy.status === "revoked"
91
- ? "revoked"
92
- : legacy.status === "active"
93
- ? "verified"
94
- : "paired_unverified";
95
-
96
- const transportState: PeerTransportState = (() => {
97
- switch (legacy.status) {
98
- case "active":
99
- return hasHandshake ? "connected" : hasEndpoint ? "endpoint_known" : "disconnected";
100
- case "pending_tunnel":
101
- return hasHandshake ? "connected" : hasEndpoint ? "connecting" : "unknown";
102
- case "pending_verification":
103
- return hasHandshake ? "connected" : hasEndpoint ? "endpoint_known" : "unknown";
104
- case "pending":
105
- return hasEndpoint ? "endpoint_known" : "unknown";
106
- case "revoked":
107
- return hasEndpoint ? "disconnected" : "unknown";
108
- }
109
- })();
110
-
111
- return PeerStateSnapshotSchema.parse({ identityState, transportState });
112
- }
113
-
114
- const IDENTITY_TRANSITIONS: Record<PeerIdentityState, readonly PeerIdentityState[]> = {
115
- invited: ["invited", "joining", "revoked"],
116
- joining: ["joining", "paired_unverified", "revoked"],
117
- paired_unverified: ["paired_unverified", "verified", "revoked"],
118
- verified: ["verified", "revoked"],
119
- revoked: ["revoked"],
120
- };
121
-
122
- export function isValidPeerIdentityTransition(
123
- from: PeerIdentityState,
124
- to: PeerIdentityState,
125
- options: { viaContinuity?: boolean } = {},
126
- ): boolean {
127
- if (from === "verified" && to === "paired_unverified") {
128
- return options.viaContinuity === true;
129
- }
130
- return IDENTITY_TRANSITIONS[from].includes(to);
131
- }
132
-
133
- const TRANSPORT_TRANSITIONS: Record<PeerTransportState, readonly PeerTransportState[]> = {
134
- unknown: ["unknown", "endpoint_known"],
135
- endpoint_known: ["endpoint_known", "connecting", "disconnected"],
136
- connecting: ["connecting", "connected", "endpoint_known", "disconnected"],
137
- connected: ["connected", "degraded", "disconnected"],
138
- degraded: ["degraded", "connected", "disconnected"],
139
- disconnected: ["disconnected", "endpoint_known"],
140
- };
141
-
142
- export function isValidPeerTransportTransition(
143
- from: PeerTransportState,
144
- to: PeerTransportState,
145
- ): boolean {
146
- return TRANSPORT_TRANSITIONS[from].includes(to);
147
- }
148
-
149
- const MUTATION_PRECEDENCE: Record<PeerMutationKind, number> = {
150
- repair: 0,
151
- continuity: 1,
152
- revocation: 2,
153
- };
154
-
155
- export function comparePeerMutationPrecedence(
156
- left: PeerMutationKind,
157
- right: PeerMutationKind,
158
- ): number {
159
- return MUTATION_PRECEDENCE[left] - MUTATION_PRECEDENCE[right];
160
- }
@@ -1,265 +0,0 @@
1
- import { z } from "zod";
2
- import {
3
- BindingGenerationSchema,
4
- ControlEndpointAdvertisementSchema,
5
- EndpointRevisionSchema,
6
- NodeAdvertisementSchema,
7
- NodeIdSchema,
8
- PeerTransportIdSchema,
9
- PublicationRevisionSchema,
10
- PrincipalFingerprintSchema,
11
- RevocationGenerationSchema,
12
- SigningPublicKeySchema,
13
- TransportEndpointAdvertisementSchema,
14
- } from "./address-types.js";
15
- export {
16
- RuntimeEventKindSchema,
17
- RuntimeEventSchema,
18
- type RuntimeEventKind,
19
- type RuntimeEvent,
20
- } from "./node-store-contract.js";
21
- import { NodePrincipalBindingRefSchema } from "./peer-principal-ref.js";
22
-
23
- const NonEmptyStringSchema = z.string().trim().min(1);
24
- // Signed transport invite tokens must preserve PEM bytes verbatim; trimming
25
- // a trailing newline changes the signed payload and breaks verification.
26
- const NonBlankVerbatimStringSchema = z
27
- .string()
28
- .min(1)
29
- .refine((value) => value.trim().length > 0);
30
- const RecordSchema = z.record(z.string(), z.unknown());
31
-
32
- function toFastifyBodyJsonSchema(schema: z.ZodTypeAny): Record<string, unknown> {
33
- const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
34
- delete jsonSchema.$schema;
35
- return jsonSchema;
36
- }
37
-
38
- export const NETWORK_RUNTIME_PROTOCOL_VERSION = 1 as const;
39
- export const NetworkRuntimeProtocolVersionSchema = z.literal(NETWORK_RUNTIME_PROTOCOL_VERSION);
40
- export type NetworkRuntimeProtocolVersion = z.infer<typeof NetworkRuntimeProtocolVersionSchema>;
41
-
42
- export function isSupportedNetworkRuntimeProtocolVersion(
43
- version: number | undefined,
44
- ): version is NetworkRuntimeProtocolVersion {
45
- return version === NETWORK_RUNTIME_PROTOCOL_VERSION;
46
- }
47
-
48
- export function assertSupportedNetworkRuntimeProtocolVersion(
49
- version: number | undefined,
50
- context = "network runtime",
51
- ): NetworkRuntimeProtocolVersion {
52
- if (!isSupportedNetworkRuntimeProtocolVersion(version)) {
53
- throw new Error(
54
- `Unsupported ${context} protocol version ${String(version)}. Supported: ${NETWORK_RUNTIME_PROTOCOL_VERSION}`,
55
- );
56
- }
57
- return version;
58
- }
59
-
60
- /**
61
- * Shared delivery-ack wire contract.
62
- * Durable settlement is keyed by stable peer identity, not display-name strings.
63
- */
64
- export const DeliveryAckSchema = z
65
- .object({
66
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
67
- messageId: NonEmptyStringSchema,
68
- senderNodeId: NodeIdSchema,
69
- recipientNodeId: NodeIdSchema,
70
- storedAt: z.number().int().nonnegative(),
71
- })
72
- .strict();
73
- export type DeliveryAck = z.infer<typeof DeliveryAckSchema>;
74
-
75
- export const TransportInviteTokenSchema = z
76
- .object({
77
- nodeId: NodeIdSchema,
78
- audienceNodeId: NodeIdSchema.optional(),
79
- publicKey: PeerTransportIdSchema,
80
- leaderDisplayNameSnapshot: NonEmptyStringSchema.optional(),
81
- host: NonEmptyStringSchema,
82
- port: z.number().int().min(1).max(65535),
83
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
84
- psk: NonEmptyStringSchema,
85
- displayNameSnapshot: NonEmptyStringSchema.optional(),
86
- signingPublicKey: SigningPublicKeySchema.optional(),
87
- caCert: NonBlankVerbatimStringSchema.optional(),
88
- createdAt: z.number().int().nonnegative(),
89
- expiresAt: z.number().int().nonnegative(),
90
- tokenNonce: NonEmptyStringSchema,
91
- coordinationUrl: NonEmptyStringSchema.optional(),
92
- networkId: NonEmptyStringSchema.optional(),
93
- })
94
- .strict();
95
- export type TransportInviteToken = z.infer<typeof TransportInviteTokenSchema>;
96
-
97
- export const JoinRequestSchema = z
98
- .object({
99
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
100
- nodeId: NodeIdSchema,
101
- principalFingerprint: PrincipalFingerprintSchema,
102
- peerPublicKey: PeerTransportIdSchema,
103
- signingPublicKey: SigningPublicKeySchema,
104
- transportEndpoint: TransportEndpointAdvertisementSchema,
105
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
106
- displayNameSnapshot: NonEmptyStringSchema.optional(),
107
- inviteTokenNonce: NonEmptyStringSchema,
108
- })
109
- .strict();
110
- export type JoinRequest = z.infer<typeof JoinRequestSchema>;
111
-
112
- export const JoinRouteBodySchema = JoinRequestSchema.extend({
113
- proofOfWork: NonEmptyStringSchema,
114
- }).strict();
115
- export type JoinRouteBody = z.infer<typeof JoinRouteBodySchema>;
116
- export const JoinRouteBodyJsonSchema = toFastifyBodyJsonSchema(JoinRouteBodySchema);
117
-
118
- export const RuntimeIngressEnvelopeSchema = z.union([
119
- z
120
- .object({
121
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
122
- deliveryAck: DeliveryAckSchema,
123
- })
124
- .strict(),
125
- z
126
- .object({
127
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
128
- ariaMessage: z.unknown(),
129
- })
130
- .strict(),
131
- z
132
- .object({
133
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
134
- joinRequest: JoinRequestSchema,
135
- })
136
- .strict(),
137
- ]);
138
- export type RuntimeIngressEnvelope = z.infer<typeof RuntimeIngressEnvelopeSchema>;
139
-
140
- export const RuntimeNodeAdvertisementSchema = NodeAdvertisementSchema.extend({
141
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
142
- publicationRevision: PublicationRevisionSchema,
143
- signingPublicKey: SigningPublicKeySchema,
144
- transportEndpoint: TransportEndpointAdvertisementSchema,
145
- advertisedHosts: z.array(NonEmptyStringSchema).min(1).optional(),
146
- }).strict();
147
- export type RuntimeNodeAdvertisement = z.infer<typeof RuntimeNodeAdvertisementSchema>;
148
-
149
- export const RuntimeDiscoveryAdvertisementSchema = z
150
- .object({
151
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
152
- nodeId: NodeIdSchema,
153
- displayNameSnapshot: NonEmptyStringSchema,
154
- principalFingerprint: PrincipalFingerprintSchema,
155
- controlPort: z.number().int().min(1).max(65535),
156
- advertisedHosts: z.array(NonEmptyStringSchema).min(1),
157
- tlsCaFingerprint: z.string().trim().min(1).optional(),
158
- })
159
- .strict();
160
- export type RuntimeDiscoveryAdvertisement = z.infer<typeof RuntimeDiscoveryAdvertisementSchema>;
161
-
162
- export const RuntimeRegisterRequestSchema = z
163
- .object({
164
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
165
- nodeId: NodeIdSchema,
166
- transportPublicKey: PeerTransportIdSchema,
167
- principalFingerprint: PrincipalFingerprintSchema,
168
- endpointRevision: EndpointRevisionSchema,
169
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
170
- displayNameSnapshot: NonEmptyStringSchema.optional(),
171
- })
172
- .strict();
173
- export type RuntimeRegisterRequest = z.infer<typeof RuntimeRegisterRequestSchema>;
174
-
175
- export const PairProposalSchema = z
176
- .object({
177
- protocolVersion: NetworkRuntimeProtocolVersionSchema,
178
- nodeId: NodeIdSchema,
179
- principalFingerprint: PrincipalFingerprintSchema,
180
- transportPublicKey: PeerTransportIdSchema,
181
- controlEndpoint: ControlEndpointAdvertisementSchema.optional(),
182
- displayNameSnapshot: NonEmptyStringSchema.optional(),
183
- presharedKey: NonEmptyStringSchema,
184
- })
185
- .strict();
186
- export type PairProposal = z.infer<typeof PairProposalSchema>;
187
-
188
- /**
189
- * Canonical statement of a continuity bind transition.
190
- * This is the byte-exact payload that both parties sign.
191
- */
192
- export const ContinuityStatementSchema = z
193
- .object({
194
- nodeId: NodeIdSchema,
195
- previousPrincipalFingerprint: PrincipalFingerprintSchema,
196
- newPrincipalFingerprint: PrincipalFingerprintSchema,
197
- newTransportPublicKey: PeerTransportIdSchema.optional(),
198
- bindingGeneration: BindingGenerationSchema,
199
- revocationGeneration: RevocationGenerationSchema.optional(),
200
- createdAt: NonEmptyStringSchema,
201
- })
202
- .strict();
203
- export type ContinuityStatement = z.infer<typeof ContinuityStatementSchema>;
204
-
205
- /**
206
- * Dual-signed continuity bind: delegation (previous principal) + acceptance
207
- * (new principal). Both public keys are included for independent verification.
208
- */
209
- export const SignedContinuityBindSchema = z
210
- .object({
211
- statement: ContinuityStatementSchema,
212
- delegationSignature: NonEmptyStringSchema,
213
- acceptanceSignature: NonEmptyStringSchema,
214
- previousPublicKey: NonEmptyStringSchema,
215
- newPublicKey: NonEmptyStringSchema,
216
- })
217
- .strict();
218
- export type SignedContinuityBind = z.infer<typeof SignedContinuityBindSchema>;
219
-
220
- export const MutationOperationSchema = z.enum([
221
- "network.register",
222
- "network.revoke",
223
- "network.list_peers",
224
- "pair.direct",
225
- "pair.relay",
226
- "pair.relay_response",
227
- "peer.update_capabilities",
228
- "peer.update_trust_tier",
229
- ]);
230
- export type MutationOperation = z.infer<typeof MutationOperationSchema>;
231
-
232
- export const MutationEnvelopeSchema = z
233
- .object({
234
- version: NetworkRuntimeProtocolVersionSchema,
235
- id: NonEmptyStringSchema,
236
- operation: MutationOperationSchema,
237
- principal: NodePrincipalBindingRefSchema,
238
- target: NodePrincipalBindingRefSchema,
239
- namespace: NonEmptyStringSchema,
240
- policyEpoch: z.number().int().nonnegative(),
241
- nonce: NonEmptyStringSchema,
242
- timestamp: z.number().int().nonnegative(),
243
- ttl: z.number().int().positive(),
244
- contextHash: NonEmptyStringSchema,
245
- payload: RecordSchema,
246
- signature: NonEmptyStringSchema,
247
- method: NonEmptyStringSchema.optional(),
248
- path: NonEmptyStringSchema.optional(),
249
- metadata: RecordSchema.optional(),
250
- reason: NonEmptyStringSchema.optional(),
251
- parentEnvelopeId: NonEmptyStringSchema.optional(),
252
- })
253
- .strict();
254
- export type MutationEnvelope = z.infer<typeof MutationEnvelopeSchema>;
255
-
256
- export const NetworkRouteRevokeRequestSchema = z
257
- .object({
258
- nodeId: NodeIdSchema,
259
- envelope: MutationEnvelopeSchema,
260
- })
261
- .strict();
262
- export type NetworkRouteRevokeRequest = z.infer<typeof NetworkRouteRevokeRequestSchema>;
263
- export const NetworkRouteRevokeRequestJsonSchema = toFastifyBodyJsonSchema(
264
- NetworkRouteRevokeRequestSchema,
265
- );