@jinn-network/client 0.1.8 → 0.1.9-canary.159b38f5

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 (229) hide show
  1. package/dist/adapters/mech/adapter.d.ts +21 -1
  2. package/dist/adapters/mech/adapter.js +67 -10
  3. package/dist/adapters/mech/adapter.js.map +1 -1
  4. package/dist/adapters/mech/contracts.js +62 -28
  5. package/dist/adapters/mech/contracts.js.map +1 -1
  6. package/dist/adapters/mech/safe-revert.d.ts +4 -0
  7. package/dist/adapters/mech/safe-revert.js +5 -1
  8. package/dist/adapters/mech/safe-revert.js.map +1 -1
  9. package/dist/adapters/mech/safe.js +5 -1
  10. package/dist/adapters/mech/safe.js.map +1 -1
  11. package/dist/api/discovery-endpoint.d.ts +1 -0
  12. package/dist/api/discovery-endpoint.js +24 -0
  13. package/dist/api/discovery-endpoint.js.map +1 -1
  14. package/dist/api/fleet-build.d.ts +1 -7
  15. package/dist/api/fleet-build.js +0 -7
  16. package/dist/api/fleet-build.js.map +1 -1
  17. package/dist/api/gather-status.d.ts +8 -2
  18. package/dist/api/gather-status.js +29 -117
  19. package/dist/api/gather-status.js.map +1 -1
  20. package/dist/api/loop-completion-build.d.ts +79 -0
  21. package/dist/api/loop-completion-build.js +155 -0
  22. package/dist/api/loop-completion-build.js.map +1 -0
  23. package/dist/api/setup-endpoints.d.ts +13 -0
  24. package/dist/api/setup-endpoints.js +39 -20
  25. package/dist/api/setup-endpoints.js.map +1 -1
  26. package/dist/api/solvernets-endpoints.js +3 -0
  27. package/dist/api/solvernets-endpoints.js.map +1 -1
  28. package/dist/api/status-build.d.ts +43 -33
  29. package/dist/api/status-build.js +3 -26
  30. package/dist/api/status-build.js.map +1 -1
  31. package/dist/api/status-rollup-build.d.ts +0 -4
  32. package/dist/api/status-rollup-build.js +0 -4
  33. package/dist/api/status-rollup-build.js.map +1 -1
  34. package/dist/build-info.json +4 -4
  35. package/dist/build-meta.json +1 -1
  36. package/dist/cli/commands/codedigest-revert-check.js +6 -2
  37. package/dist/cli/commands/codedigest-revert-check.js.map +1 -1
  38. package/dist/cli/commands/doctor.d.ts +3 -0
  39. package/dist/cli/commands/doctor.js +35 -0
  40. package/dist/cli/commands/doctor.js.map +1 -1
  41. package/dist/cli/commands/eval.d.ts +76 -0
  42. package/dist/cli/commands/eval.js +401 -0
  43. package/dist/cli/commands/eval.js.map +1 -0
  44. package/dist/cli/commands/rewards.d.ts +2 -0
  45. package/dist/cli/commands/rewards.js +27 -0
  46. package/dist/cli/commands/rewards.js.map +1 -1
  47. package/dist/cli/commands/solver-nets.js +68 -0
  48. package/dist/cli/commands/solver-nets.js.map +1 -1
  49. package/dist/cli/commands/status.js +0 -1
  50. package/dist/cli/commands/status.js.map +1 -1
  51. package/dist/cli/index.js +2 -0
  52. package/dist/cli/index.js.map +1 -1
  53. package/dist/config.d.ts +31 -7
  54. package/dist/config.js +72 -7
  55. package/dist/config.js.map +1 -1
  56. package/dist/daemon/ai-units-gate.d.ts +6 -6
  57. package/dist/daemon/ai-units-gate.js +11 -10
  58. package/dist/daemon/ai-units-gate.js.map +1 -1
  59. package/dist/daemon/daemon.js +24 -22
  60. package/dist/daemon/daemon.js.map +1 -1
  61. package/dist/daemon/eviction-loop.d.ts +7 -0
  62. package/dist/daemon/eviction-loop.js +16 -0
  63. package/dist/daemon/eviction-loop.js.map +1 -1
  64. package/dist/dashboard/assets/index-BVAWkLwY.css +1 -0
  65. package/dist/dashboard/assets/index-DEPqtGOA.js +167 -0
  66. package/dist/dashboard/index.html +2 -2
  67. package/dist/discovery/http.d.ts +7 -0
  68. package/dist/discovery/http.js +241 -25
  69. package/dist/discovery/http.js.map +1 -1
  70. package/dist/discovery/onchain.js +155 -1
  71. package/dist/discovery/onchain.js.map +1 -1
  72. package/dist/discovery/types.d.ts +106 -0
  73. package/dist/discovery/types.js +40 -0
  74. package/dist/discovery/types.js.map +1 -1
  75. package/dist/discovery/with-fallback.js +14 -0
  76. package/dist/discovery/with-fallback.js.map +1 -1
  77. package/dist/earning/bootstrap.d.ts +23 -0
  78. package/dist/earning/bootstrap.js +76 -27
  79. package/dist/earning/bootstrap.js.map +1 -1
  80. package/dist/earning/faucet.d.ts +1 -1
  81. package/dist/earning/faucet.js +2 -2
  82. package/dist/earning/faucet.js.map +1 -1
  83. package/dist/earning/safe-adapter.js +11 -0
  84. package/dist/earning/safe-adapter.js.map +1 -1
  85. package/dist/eval/eval-harness-run.d.ts +63 -0
  86. package/dist/eval/eval-harness-run.js +123 -0
  87. package/dist/eval/eval-harness-run.js.map +1 -0
  88. package/dist/eval/orchestrator.d.ts +163 -0
  89. package/dist/eval/orchestrator.js +232 -0
  90. package/dist/eval/orchestrator.js.map +1 -0
  91. package/dist/eval/paired.d.ts +68 -0
  92. package/dist/eval/paired.js +93 -0
  93. package/dist/eval/paired.js.map +1 -0
  94. package/dist/eval/resolve-slate-tasks.d.ts +35 -0
  95. package/dist/eval/resolve-slate-tasks.js +56 -0
  96. package/dist/eval/resolve-slate-tasks.js.map +1 -0
  97. package/dist/eval/screen-discovery.d.ts +22 -0
  98. package/dist/eval/screen-discovery.js +71 -0
  99. package/dist/eval/screen-discovery.js.map +1 -0
  100. package/dist/eval/screen-progress.d.ts +41 -0
  101. package/dist/eval/screen-progress.js +60 -0
  102. package/dist/eval/screen-progress.js.map +1 -0
  103. package/dist/eval/screen-runner.d.ts +30 -0
  104. package/dist/eval/screen-runner.js +289 -0
  105. package/dist/eval/screen-runner.js.map +1 -0
  106. package/dist/eval/screen.d.ts +107 -0
  107. package/dist/eval/screen.js +159 -0
  108. package/dist/eval/screen.js.map +1 -0
  109. package/dist/eval/slope.d.ts +29 -0
  110. package/dist/eval/slope.js +46 -0
  111. package/dist/eval/slope.js.map +1 -0
  112. package/dist/eval/train-sequence.d.ts +35 -0
  113. package/dist/eval/train-sequence.js +59 -0
  114. package/dist/eval/train-sequence.js.map +1 -0
  115. package/dist/eval/wilson.d.ts +45 -0
  116. package/dist/eval/wilson.js +48 -0
  117. package/dist/eval/wilson.js.map +1 -0
  118. package/dist/harnesses/engine/canonical-json.js +5 -3
  119. package/dist/harnesses/engine/canonical-json.js.map +1 -1
  120. package/dist/harnesses/engine/engine.d.ts +9 -0
  121. package/dist/harnesses/engine/engine.js +50 -5
  122. package/dist/harnesses/engine/engine.js.map +1 -1
  123. package/dist/harnesses/engine/persistence.d.ts +17 -0
  124. package/dist/harnesses/engine/persistence.js +28 -0
  125. package/dist/harnesses/engine/persistence.js.map +1 -1
  126. package/dist/harnesses/impls/hermes-agent/adapter.d.ts +2 -0
  127. package/dist/harnesses/impls/hermes-agent/adapter.js +8 -5
  128. package/dist/harnesses/impls/hermes-agent/adapter.js.map +1 -1
  129. package/dist/harnesses/impls/hermes-agent/bootstrap.d.ts +1 -0
  130. package/dist/harnesses/impls/hermes-agent/bootstrap.js +6 -1
  131. package/dist/harnesses/impls/hermes-agent/bootstrap.js.map +1 -1
  132. package/dist/harnesses/impls/hermes-agent/harness.d.ts +17 -3
  133. package/dist/harnesses/impls/hermes-agent/harness.js +68 -5
  134. package/dist/harnesses/impls/hermes-agent/harness.js.map +1 -1
  135. package/dist/harnesses/impls/index.d.ts +2 -0
  136. package/dist/harnesses/impls/index.js +2 -0
  137. package/dist/harnesses/impls/index.js.map +1 -1
  138. package/dist/harnesses/impls/learner/adapters/claude-code.js +5 -0
  139. package/dist/harnesses/impls/learner/adapters/claude-code.js.map +1 -1
  140. package/dist/harnesses/impls/learner/harness.d.ts +17 -1
  141. package/dist/harnesses/impls/learner/harness.js +51 -1
  142. package/dist/harnesses/impls/learner/harness.js.map +1 -1
  143. package/dist/harnesses/impls/learner/harvest.d.ts +2 -0
  144. package/dist/harnesses/impls/learner/harvest.js +7 -1
  145. package/dist/harnesses/impls/learner/harvest.js.map +1 -1
  146. package/dist/harnesses/impls/learner/plugin-path.js +1 -0
  147. package/dist/harnesses/impls/learner/plugin-path.js.map +1 -1
  148. package/dist/harnesses/impls/swe-rebench-v2-evaluator/harness.js +3 -1
  149. package/dist/harnesses/impls/swe-rebench-v2-evaluator/harness.js.map +1 -1
  150. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.d.ts +2 -2
  151. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js +3 -1
  152. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js.map +1 -1
  153. package/dist/harnesses/types.d.ts +14 -0
  154. package/dist/learner/revert-decision.d.ts +16 -1
  155. package/dist/learner/revert-decision.js +38 -18
  156. package/dist/learner/revert-decision.js.map +1 -1
  157. package/dist/learner/revert-stats.d.ts +14 -0
  158. package/dist/learner/revert-stats.js +42 -0
  159. package/dist/learner/revert-stats.js.map +1 -1
  160. package/dist/local-provider-url.d.ts +3 -0
  161. package/dist/local-provider-url.js +28 -0
  162. package/dist/local-provider-url.js.map +1 -0
  163. package/dist/main.js +22 -0
  164. package/dist/main.js.map +1 -1
  165. package/dist/plugins/learner/.claude-plugin/plugin.json +1 -1
  166. package/dist/plugins/learner/.codex-plugin/plugin.json +1 -1
  167. package/dist/plugins/learner/hooks/session-start +30 -1
  168. package/dist/plugins/learner/skills/learn/consolidator-prompt.md +4 -0
  169. package/dist/preflight/deployment-readiness.d.ts +147 -0
  170. package/dist/preflight/deployment-readiness.js +366 -0
  171. package/dist/preflight/deployment-readiness.js.map +1 -0
  172. package/dist/preflight/pidfile-liveness.d.ts +7 -1
  173. package/dist/preflight/pidfile-liveness.js +14 -0
  174. package/dist/preflight/pidfile-liveness.js.map +1 -1
  175. package/dist/rpc/transport.d.ts +36 -0
  176. package/dist/rpc/transport.js +123 -24
  177. package/dist/rpc/transport.js.map +1 -1
  178. package/dist/scripts/swe-rebench-v2-seed-pool.json +2 -1
  179. package/dist/solver-types/_swe-rebench-v2-held-out-slate.d.ts +76 -0
  180. package/dist/solver-types/_swe-rebench-v2-held-out-slate.js +156 -0
  181. package/dist/solver-types/_swe-rebench-v2-held-out-slate.js.map +1 -0
  182. package/dist/solver-types/_swe-rebench-v2-pool-recovery.d.ts +81 -0
  183. package/dist/solver-types/_swe-rebench-v2-pool-recovery.js +116 -0
  184. package/dist/solver-types/_swe-rebench-v2-pool-recovery.js.map +1 -0
  185. package/dist/solver-types/_swe-rebench-v2-state.d.ts +9 -0
  186. package/dist/solver-types/_swe-rebench-v2-state.js +14 -0
  187. package/dist/solver-types/_swe-rebench-v2-state.js.map +1 -1
  188. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v1.json +20 -0
  189. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v2.json +19 -0
  190. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v2.screening-report.json +628 -0
  191. package/dist/solver-types/solver-type.d.ts +8 -0
  192. package/dist/solver-types/swe-rebench-v2.d.ts +2 -0
  193. package/dist/solver-types/swe-rebench-v2.js +106 -2
  194. package/dist/solver-types/swe-rebench-v2.js.map +1 -1
  195. package/dist/solvernets/launched-record-dispatcher.d.ts +3 -0
  196. package/dist/solvernets/launched-record-dispatcher.js.map +1 -1
  197. package/dist/solvernets/registry-client-erc8004.js +29 -37
  198. package/dist/solvernets/registry-client-erc8004.js.map +1 -1
  199. package/dist/solvernets/registry-client.d.ts +6 -0
  200. package/dist/solvernets/store.js +7 -2
  201. package/dist/solvernets/store.js.map +1 -1
  202. package/dist/spend/ai-units-config.d.ts +10 -0
  203. package/dist/spend/ai-units-config.js +7 -1
  204. package/dist/spend/ai-units-config.js.map +1 -1
  205. package/dist/spend/ai-units.d.ts +51 -0
  206. package/dist/spend/ai-units.js +73 -0
  207. package/dist/spend/ai-units.js.map +1 -1
  208. package/dist/spend/record.js +12 -5
  209. package/dist/spend/record.js.map +1 -1
  210. package/dist/store/store.d.ts +91 -5
  211. package/dist/store/store.js +170 -7
  212. package/dist/store/store.js.map +1 -1
  213. package/dist/vendor/@jinn-network/sdk/dist/payloads/swe-rebench-v2.d.ts +108 -1
  214. package/dist/vendor/@jinn-network/sdk/dist/payloads/swe-rebench-v2.js +25 -1
  215. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2-held-out-slate.d.ts +65 -0
  216. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2-held-out-slate.js +123 -0
  217. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.d.ts +2 -2
  218. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.js +1 -1
  219. package/dist/vendor/@jinn-network/sdk/package.json +4 -0
  220. package/docker-compose.yml +3 -2
  221. package/package.json +22 -18
  222. package/plugins/learner/.claude-plugin/plugin.json +1 -1
  223. package/plugins/learner/.codex-plugin/plugin.json +1 -1
  224. package/plugins/learner/hooks/session-start +30 -1
  225. package/plugins/learner/skills/learn/consolidator-prompt.md +4 -0
  226. package/plugins/swe-rebench-v2-runtime/hooks/hooks.json +16 -0
  227. package/plugins/swe-rebench-v2-runtime/hooks/session-start +74 -0
  228. package/dist/dashboard/assets/index-CzKxvMcU.css +0 -32
  229. package/dist/dashboard/assets/index-yVemxHot.js +0 -351
@@ -0,0 +1,366 @@
1
+ /**
2
+ * Deployment-readiness preflight (issue #958).
3
+ *
4
+ * Hosted deploys have no boot-time guard that the environment is fit to run;
5
+ * misconfig fails silently or mid-run. This module adds a set of checks that
6
+ * answer "is this environment fit to run the daemon?" and a boot gate that
7
+ * **fails loud — but only in a deployment context**.
8
+ *
9
+ * Load-bearing constraint: a plain local `jinn run` (no `JINN_STATE_DIR`,
10
+ * running as the user, no relayer configured) must NEVER be newly gated. The
11
+ * fail-loud boot gate fires only when `isDeploymentContext()` is true; outside
12
+ * that, every check is advisory (surfaced in `doctor`, never boot-fatal). The
13
+ * `doctor` command runs all checks regardless of context.
14
+ *
15
+ * The checks compose existing primitives where possible:
16
+ * - `writable_volume` — the one genuinely new primitive (write+fsync+unlink probe)
17
+ * - `state_on_volume` — assert resolved state lives on the configured volume
18
+ * - `credentials_resolvable` — reuses `detectAuthContext`; presence-only, NEVER echoes secrets
19
+ * - `relayer_reachable` — cheap probe; skip-ok when no relayer endpoint is configured
20
+ * - `agent_cli_non_root` — uid 0 is unfit (the agent CLI refuses to run as root)
21
+ *
22
+ * Every check is side-effect-light and NEVER throws — a failure becomes a
23
+ * structured fail result, not an exception. The aggregate is the safe caller
24
+ * surface; the gate adds the fail-loud envelope on top.
25
+ */
26
+ import { promises as fs } from 'node:fs';
27
+ import { join, resolve } from 'node:path';
28
+ import { randomBytes } from 'node:crypto';
29
+ import { emitEnvelope } from '../errors/envelope.js';
30
+ import { emitStructured } from '../events/emitter.js';
31
+ /** Hard checks — failing one of these in a deployment context refuses the boot. */
32
+ const HARD_CHECK_NAMES = new Set([
33
+ 'writable_volume',
34
+ 'state_on_volume',
35
+ 'agent_cli_non_root',
36
+ ]);
37
+ // ---------------------------------------------------------------------------
38
+ // isDeploymentContext
39
+ // ---------------------------------------------------------------------------
40
+ /**
41
+ * Deployment context = `JINN_STATE_DIR` set OR `config.stateDir` set OR the
42
+ * auth context is a container / docker-compose. A plain local operator (bare
43
+ * context, no state-dir) is NOT a deployment context, so the boot gate stays
44
+ * disarmed for them.
45
+ */
46
+ export function isDeploymentContext(input) {
47
+ if (typeof input.env['JINN_STATE_DIR'] === 'string' && input.env['JINN_STATE_DIR'].length > 0) {
48
+ return true;
49
+ }
50
+ if (typeof input.stateDir === 'string' && input.stateDir.length > 0)
51
+ return true;
52
+ return input.authContext === 'container' || input.authContext === 'docker-compose';
53
+ }
54
+ // ---------------------------------------------------------------------------
55
+ // writable_volume — the new primitive
56
+ // ---------------------------------------------------------------------------
57
+ /**
58
+ * Attempt to write + fsync + unlink a temp file under `dir`. ok when it
59
+ * succeeds; structured fail (never throws) on EACCES / EROFS / ENOSPC / missing
60
+ * dir / any other fs error.
61
+ */
62
+ export async function checkWritableVolume(dir) {
63
+ const probePath = join(dir, `.jinn-writeprobe-${process.pid}-${randomBytes(4).toString('hex')}`);
64
+ let handle;
65
+ try {
66
+ handle = await fs.open(probePath, 'w', 0o600);
67
+ await handle.write('jinn-writable-volume-probe');
68
+ await handle.sync();
69
+ await handle.close();
70
+ handle = undefined;
71
+ await fs.unlink(probePath);
72
+ return {
73
+ name: 'writable_volume',
74
+ ok: true,
75
+ detail: `${dir} is writable`,
76
+ };
77
+ }
78
+ catch (err) {
79
+ // Best-effort cleanup; ignore whatever it throws.
80
+ if (handle)
81
+ await handle.close().catch(() => undefined);
82
+ await fs.unlink(probePath).catch(() => undefined);
83
+ const code = err.code;
84
+ return {
85
+ name: 'writable_volume',
86
+ ok: false,
87
+ detail: `${dir} is not writable${code ? ` (${code})` : ''}`,
88
+ remedy: 'Ensure the daemon process can write to the state directory. In hosted deploys, mount a writable ' +
89
+ 'persistent volume at the path pointed to by JINN_STATE_DIR (or earningDir) and give the daemon user write access.',
90
+ };
91
+ }
92
+ }
93
+ // ---------------------------------------------------------------------------
94
+ // state_on_volume
95
+ // ---------------------------------------------------------------------------
96
+ /**
97
+ * In a deployment context, assert resolved state lives on the configured
98
+ * volume — i.e. `stateDir` is set AND `earningDir` resolves under it. Advisory
99
+ * (always ok) outside a deployment context.
100
+ */
101
+ export function checkStateOnVolume(input) {
102
+ if (!input.deployment) {
103
+ return {
104
+ name: 'state_on_volume',
105
+ ok: true,
106
+ detail: 'not a deployment context — state location is advisory only',
107
+ };
108
+ }
109
+ if (!input.stateDir) {
110
+ return {
111
+ name: 'state_on_volume',
112
+ ok: false,
113
+ detail: 'deployment context but JINN_STATE_DIR / stateDir is unset — state would land on the ephemeral ~/.jinn-client default and be lost on redeploy',
114
+ remedy: 'Set JINN_STATE_DIR to the mounted persistent volume (e.g. JINN_STATE_DIR=/data).',
115
+ };
116
+ }
117
+ const root = resolve(input.stateDir);
118
+ const earning = resolve(input.earningDir);
119
+ const under = earning === root || earning.startsWith(root + '/');
120
+ if (!under) {
121
+ return {
122
+ name: 'state_on_volume',
123
+ ok: false,
124
+ detail: `earningDir (${earning}) does not resolve under the configured volume (${root})`,
125
+ remedy: 'Remove the per-key earningDir/dbPath override so state derives under JINN_STATE_DIR, or point them at the volume.',
126
+ };
127
+ }
128
+ return {
129
+ name: 'state_on_volume',
130
+ ok: true,
131
+ detail: `state resolves under the configured volume ${root}`,
132
+ };
133
+ }
134
+ // ---------------------------------------------------------------------------
135
+ // credentials_resolvable
136
+ // ---------------------------------------------------------------------------
137
+ /**
138
+ * Presence-only credential check. In a bare context the operator authenticates
139
+ * the agent CLI interactively (claude session auth), so credentials are not
140
+ * env-resolvable and that is fine. In a container / compose context there is no
141
+ * interactive login, so SOME agent-CLI auth signal must be present in the env.
142
+ *
143
+ * NEVER returns or logs a secret value — only presence + context.
144
+ */
145
+ export function checkCredentialsResolvable(input) {
146
+ // Env vars that, if present and non-empty, indicate the agent CLI can resolve
147
+ // credentials non-interactively. Presence only — values are never read out.
148
+ const AUTH_ENV_KEYS = [
149
+ 'ANTHROPIC_API_KEY',
150
+ 'CLAUDE_CODE_OAUTH_TOKEN',
151
+ 'OPENROUTER_API_KEY',
152
+ 'OPENAI_API_KEY',
153
+ ];
154
+ const present = AUTH_ENV_KEYS.filter((k) => {
155
+ const v = input.env[k];
156
+ return typeof v === 'string' && v.trim().length > 0;
157
+ });
158
+ if (input.context === 'bare') {
159
+ return {
160
+ name: 'credentials_resolvable',
161
+ ok: true,
162
+ detail: present.length > 0
163
+ ? `bare context; agent-CLI auth env present (${present.length} key(s))`
164
+ : 'bare context; agent CLI uses interactive session auth',
165
+ };
166
+ }
167
+ // container / docker-compose: no interactive login path — need an env signal.
168
+ if (present.length > 0) {
169
+ return {
170
+ name: 'credentials_resolvable',
171
+ ok: true,
172
+ detail: `${input.context} context; agent-CLI auth env present (${present.length} key(s))`,
173
+ };
174
+ }
175
+ return {
176
+ name: 'credentials_resolvable',
177
+ ok: false,
178
+ detail: `${input.context} context but no agent-CLI auth credential is resolvable from the environment`,
179
+ remedy: 'Provide the agent CLI credentials the harness needs (e.g. ANTHROPIC_API_KEY / CLAUDE_CODE_OAUTH_TOKEN, ' +
180
+ 'or OPENROUTER_API_KEY for the hermes harness) as a secret in the deploy environment.',
181
+ };
182
+ }
183
+ // ---------------------------------------------------------------------------
184
+ // relayer_reachable
185
+ // ---------------------------------------------------------------------------
186
+ /**
187
+ * If a relayer endpoint is configured, probe it (short-timeout HEAD/GET). If
188
+ * not configured, skip-ok. Never throws.
189
+ *
190
+ * Production passes `relayerUrl: undefined` today — no config field plumbs a
191
+ * relayer URL (the claim-relayer is a contract-level / off-process concept), so
192
+ * this degrades to skip-ok. The injectable surface keeps the reachable /
193
+ * unreachable paths testable.
194
+ */
195
+ export async function checkRelayerReachable(relayerUrl, fetchImpl) {
196
+ if (!relayerUrl) {
197
+ return {
198
+ name: 'relayer_reachable',
199
+ ok: true,
200
+ detail: 'no claim-relayer endpoint configured — skipped',
201
+ };
202
+ }
203
+ const controller = new AbortController();
204
+ const timer = setTimeout(() => controller.abort(), 3000);
205
+ try {
206
+ const res = (await fetchImpl(relayerUrl, {
207
+ method: 'HEAD',
208
+ signal: controller.signal,
209
+ }));
210
+ const status = typeof res.status === 'number' ? res.status : undefined;
211
+ const reachable = res.ok === true || (status !== undefined && status >= 200 && status < 400);
212
+ if (reachable) {
213
+ return {
214
+ name: 'relayer_reachable',
215
+ ok: true,
216
+ detail: `claim-relayer responded${status !== undefined ? ` (${status})` : ''}`,
217
+ };
218
+ }
219
+ return {
220
+ name: 'relayer_reachable',
221
+ ok: false,
222
+ detail: `claim-relayer responded with a non-success status${status !== undefined ? ` (${status})` : ''}`,
223
+ remedy: 'Check the relayer service health and the configured endpoint.',
224
+ };
225
+ }
226
+ catch (err) {
227
+ const msg = err instanceof Error ? err.message : String(err);
228
+ return {
229
+ name: 'relayer_reachable',
230
+ ok: false,
231
+ detail: `claim-relayer unreachable: ${msg}`,
232
+ remedy: 'Verify the relayer service is running and the endpoint/network path is reachable.',
233
+ };
234
+ }
235
+ finally {
236
+ clearTimeout(timer);
237
+ }
238
+ }
239
+ // ---------------------------------------------------------------------------
240
+ // agent_cli_non_root
241
+ // ---------------------------------------------------------------------------
242
+ /**
243
+ * ok when uid !== 0 (or no getuid on the platform). Fail when running as root —
244
+ * the agent CLI refuses to run as root, so a root daemon is unfit. Never throws.
245
+ */
246
+ export function checkAgentCliNonRoot(getuid) {
247
+ if (typeof getuid !== 'function') {
248
+ return {
249
+ name: 'agent_cli_non_root',
250
+ ok: true,
251
+ detail: 'platform has no uid concept — non-root assumption holds',
252
+ };
253
+ }
254
+ let uid;
255
+ try {
256
+ uid = getuid();
257
+ }
258
+ catch {
259
+ // Can't determine uid: don't crash, treat as non-fatal (conservative ok —
260
+ // we'd rather not falsely gate a boot on an unreadable uid).
261
+ return {
262
+ name: 'agent_cli_non_root',
263
+ ok: true,
264
+ detail: 'could not read process uid — assuming non-root',
265
+ };
266
+ }
267
+ if (uid === 0) {
268
+ return {
269
+ name: 'agent_cli_non_root',
270
+ ok: false,
271
+ detail: 'daemon is running as root (uid 0); the agent CLI refuses to run as root',
272
+ remedy: 'Run the daemon as a non-root user. In containers, create and drop to a non-root user (e.g. via gosu) before launching.',
273
+ };
274
+ }
275
+ return {
276
+ name: 'agent_cli_non_root',
277
+ ok: true,
278
+ detail: `running as non-root (uid ${uid})`,
279
+ };
280
+ }
281
+ // ---------------------------------------------------------------------------
282
+ // runDeploymentReadinessChecks — the aggregate
283
+ // ---------------------------------------------------------------------------
284
+ /**
285
+ * Run every deployment-readiness check and assemble a report. Detects the
286
+ * deployment context internally and decides `bootFatal` accordingly. Never
287
+ * throws — each check degrades to a structured fail.
288
+ */
289
+ export async function runDeploymentReadinessChecks(inputs, deps) {
290
+ const authContext = (() => {
291
+ try {
292
+ return deps.detectAuthContext({
293
+ cwd: process.cwd(),
294
+ env: deps.env,
295
+ configuredMode: inputs.runtimeMode,
296
+ });
297
+ }
298
+ catch {
299
+ return 'bare';
300
+ }
301
+ })();
302
+ const deployment = isDeploymentContext({
303
+ env: deps.env,
304
+ authContext,
305
+ stateDir: inputs.stateDir,
306
+ });
307
+ // The writable-volume probe targets the volume root when set, else earningDir.
308
+ const probeDir = inputs.stateDir ?? inputs.earningDir;
309
+ const checks = [
310
+ await checkWritableVolume(probeDir),
311
+ checkStateOnVolume({ deployment, stateDir: inputs.stateDir, earningDir: inputs.earningDir }),
312
+ checkCredentialsResolvable({ context: authContext, env: deps.env }),
313
+ await checkRelayerReachable(inputs.relayerUrl, deps.fetch),
314
+ checkAgentCliNonRoot(deps.getuid),
315
+ ];
316
+ const bootFatal = deployment && checks.some((c) => !c.ok && HARD_CHECK_NAMES.has(c.name));
317
+ return { deployment, authContext, checks, bootFatal };
318
+ }
319
+ // ---------------------------------------------------------------------------
320
+ // applyDeploymentReadinessGate — the boot gate (fail-loud only in deployment)
321
+ // ---------------------------------------------------------------------------
322
+ /**
323
+ * Boot gate for `jinn run`. Runs the readiness aggregate; in a deployment
324
+ * context, fail loud (emit `invalid_invocation` envelope + non-zero exit) when
325
+ * a hard check fails. Outside a deployment context, log advisories for any
326
+ * failing check and proceed. Mirrors `applyPidfileLivenessGate`'s contract:
327
+ * `emitEnvelope` does not return in production (it `process.exit`s).
328
+ */
329
+ export async function applyDeploymentReadinessGate(inputs, deps, sinks = {}) {
330
+ const report = await runDeploymentReadinessChecks(inputs, deps);
331
+ const failed = report.checks.filter((c) => !c.ok);
332
+ if (report.bootFatal) {
333
+ const hardFailures = failed.filter((c) => HARD_CHECK_NAMES.has(c.name));
334
+ const summary = hardFailures.map((c) => `${c.name}: ${c.detail}`).join('; ');
335
+ emitEnvelope({
336
+ code: 'invalid_invocation',
337
+ message: `Environment is not fit to run the daemon in this deployment — ${summary}`,
338
+ hint: 'Run `jinn doctor --human` for the full readiness report. Fix the failing check(s) and restart.',
339
+ exampleCli: 'jinn doctor --human',
340
+ details: {
341
+ field: 'deployment_readiness',
342
+ authContext: report.authContext,
343
+ // Names + ok only — no secret material, no raw env values.
344
+ failed: hardFailures.map((c) => ({ name: c.name, detail: c.detail })),
345
+ },
346
+ }, sinks);
347
+ // emitEnvelope calls process.exit in production; in tests the injected exit
348
+ // is a no-op. Either way, do not fall through to "proceed" logging.
349
+ return;
350
+ }
351
+ // Advisory path (local operator, or non-hard failures in a deployment ctx):
352
+ // surface each failing check but never gate the boot.
353
+ for (const c of failed) {
354
+ emitStructured({
355
+ kind: 'system',
356
+ message: `deployment-readiness advisory — ${c.name}: ${c.detail}`,
357
+ details: {
358
+ phase: 'preflight',
359
+ check: c.name,
360
+ deployment: report.deployment,
361
+ ...(c.remedy ? { remedy: c.remedy } : {}),
362
+ },
363
+ });
364
+ }
365
+ }
366
+ //# sourceMappingURL=deployment-readiness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deployment-readiness.js","sourceRoot":"","sources":["../../src/preflight/deployment-readiness.ts"],"names":[],"mappings":"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"}
@@ -6,11 +6,17 @@
6
6
  * Branches (load-bearing — see #649 acceptance criteria):
7
7
  * - File missing → { decision: 'proceed' }
8
8
  * - File malformed (NaN/empty) → { decision: 'unlink-stale', reason: 'malformed' }
9
+ * - PID 1 or our own pid → { decision: 'unlink-stale', reason: 'self-or-pid1-container' }
9
10
  * - process.kill(pid, 0) ESRCH → { decision: 'unlink-stale', reason: 'esrch' }
10
11
  * - process.kill(pid, 0) ok → { decision: 'refuse', reason: 'alive' }
11
12
  * - process.kill(pid, 0) EPERM → { decision: 'refuse', reason: 'eperm' }
12
13
  * - any other errno → { decision: 'refuse', reason: 'unknown' }
13
14
  *
15
+ * The PID-1/self branch classifies *before* the `process.kill` probe (#805): in
16
+ * a container the daemon is PID 1, whose pidfile outlives the container on the
17
+ * persistent volume; `process.kill(1, 0)` always succeeds, so a probe-first
18
+ * order would mis-classify the stale record as a live sibling and crash-loop.
19
+ *
14
20
  * `.trim()` before `parseInt` is required: `main.ts` writes the PID with a
15
21
  * trailing `\n` (see `client/src/main.ts` writeFileSync near the pidfile site).
16
22
  */
@@ -21,7 +27,7 @@ export type PidfileLivenessDecision = {
21
27
  decision: 'unlink-stale';
22
28
  pid: number | null;
23
29
  pidfilePath: string;
24
- reason: 'malformed' | 'esrch';
30
+ reason: 'malformed' | 'esrch' | 'self-or-pid1-container';
25
31
  } | {
26
32
  decision: 'refuse';
27
33
  pid: number;
@@ -6,11 +6,17 @@
6
6
  * Branches (load-bearing — see #649 acceptance criteria):
7
7
  * - File missing → { decision: 'proceed' }
8
8
  * - File malformed (NaN/empty) → { decision: 'unlink-stale', reason: 'malformed' }
9
+ * - PID 1 or our own pid → { decision: 'unlink-stale', reason: 'self-or-pid1-container' }
9
10
  * - process.kill(pid, 0) ESRCH → { decision: 'unlink-stale', reason: 'esrch' }
10
11
  * - process.kill(pid, 0) ok → { decision: 'refuse', reason: 'alive' }
11
12
  * - process.kill(pid, 0) EPERM → { decision: 'refuse', reason: 'eperm' }
12
13
  * - any other errno → { decision: 'refuse', reason: 'unknown' }
13
14
  *
15
+ * The PID-1/self branch classifies *before* the `process.kill` probe (#805): in
16
+ * a container the daemon is PID 1, whose pidfile outlives the container on the
17
+ * persistent volume; `process.kill(1, 0)` always succeeds, so a probe-first
18
+ * order would mis-classify the stale record as a live sibling and crash-loop.
19
+ *
14
20
  * `.trim()` before `parseInt` is required: `main.ts` writes the PID with a
15
21
  * trailing `\n` (see `client/src/main.ts` writeFileSync near the pidfile site).
16
22
  */
@@ -35,6 +41,14 @@ export function checkPidfileLiveness(input) {
35
41
  if (!Number.isFinite(parsed) || parsed <= 0) {
36
42
  return { decision: 'unlink-stale', pid: null, pidfilePath: pidPath, reason: 'malformed' };
37
43
  }
44
+ // #805: in a container the daemon is PID 1; the pidfile on the persistent
45
+ // volume outlives the container, and `process.kill(1, 0)` always succeeds, so
46
+ // we must classify the self/PID-1 record as stale *before* the liveness probe
47
+ // below — otherwise the probe reports it alive and the daemon crash-loops. A
48
+ // record of our own pid is likewise self, never a live sibling.
49
+ if (parsed === 1 || parsed === process.pid) {
50
+ return { decision: 'unlink-stale', pid: parsed, pidfilePath: pidPath, reason: 'self-or-pid1-container' };
51
+ }
38
52
  try {
39
53
  process.kill(parsed, 0);
40
54
  return { decision: 'refuse', pid: parsed, pidfilePath: pidPath, reason: 'alive' };
@@ -1 +1 @@
1
- {"version":3,"file":"pidfile-liveness.js","sourceRoot":"","sources":["../../src/preflight/pidfile-liveness.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pidfile-liveness.js","sourceRoot":"","sources":["../../src/preflight/pidfile-liveness.ts"],"names":[],"mappings":"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"}
@@ -79,6 +79,31 @@ export declare class AllRpcsFailedError extends Error {
79
79
  * viem's `buildRequest` re-wrap pass).
80
80
  */
81
81
  export declare function isViemShouldThrowError(err: unknown): boolean;
82
+ /**
83
+ * Default cooldown applied to a slot that returns a quota / rate-limit error
84
+ * (#835). After this window the demoted slot becomes eligible again rather than
85
+ * being permanently disabled (AC2), so a transient 429 / monthly-quota blip
86
+ * never strands an operator on a degraded provider for the rest of the process.
87
+ */
88
+ export declare const DEFAULT_RPC_COOLDOWN_MS = 60000;
89
+ /**
90
+ * Detect quota / rate-limit errors from an RPC provider (#835). Unlike
91
+ * {@link isViemShouldThrowError} (which marks EVM/wallet-level signals that must
92
+ * NOT trigger fallback), a quota error means the *slot* is temporarily unusable
93
+ * and should be demoted behind healthy slots for a cooldown window. Walks the
94
+ * cause chain (cycle-safe, mirroring `isViemShouldThrowError`) and matches on:
95
+ * - HTTP `status === 429` (the `http()` transport's `HttpRequestError`);
96
+ * - JSON-RPC `code === LimitExceededRpcError.code` (-32005);
97
+ * - a narrow message regex backstop covering unambiguous provider phrasings
98
+ * ("rate limit", "too many requests", "429", "quota", "compute unit",
99
+ * "request rate", "throughput") — deliberately excluding the ambiguous
100
+ * "limit"/"exceeded" words that collide with gas-limit errors.
101
+ *
102
+ * Deliberately narrow: a 5xx / network error is NOT a quota error (it falls
103
+ * through via viem but does not cool the slot — AC3 keeps static order when no
104
+ * quota errors occur), and a contract revert (code 3) is never a quota error.
105
+ */
106
+ export declare function isRpcQuotaError(err: unknown): boolean;
82
107
  /**
83
108
  * Mask an RPC URL down to its hostname for display / error reporting. Drops
84
109
  * the path so api-key segments in the URL don't leak into logs.
@@ -91,6 +116,17 @@ export interface BuildFallbackTransportOptions {
91
116
  * "Tenderly stays in slot 3" constraint from the issue.
92
117
  */
93
118
  rank?: boolean;
119
+ /**
120
+ * Injectable clock for the quota-cooldown bookkeeping (#835). Defaults to
121
+ * {@link Date.now}. Tests pass a controllable stub so cooldown expiry (AC2)
122
+ * is deterministic without real timers.
123
+ */
124
+ now?: () => number;
125
+ /**
126
+ * How long a slot stays demoted after a quota / rate-limit error, in ms
127
+ * (#835). Defaults to {@link DEFAULT_RPC_COOLDOWN_MS}.
128
+ */
129
+ cooldownMs?: number;
94
130
  }
95
131
  /**
96
132
  * Build a viem fallback transport over the given URLs. Returns a callable