@cuna_labs/cli 0.1.0

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 (624) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +9 -0
  3. package/README.md +169 -0
  4. package/THIRD_PARTY_NOTICES.md +29 -0
  5. package/dist/api/capability-evidence.d.ts +19 -0
  6. package/dist/api/capability-evidence.d.ts.map +1 -0
  7. package/dist/api/capability-evidence.js +38 -0
  8. package/dist/api/capability-evidence.js.map +1 -0
  9. package/dist/api/client.d.ts +167 -0
  10. package/dist/api/client.d.ts.map +1 -0
  11. package/dist/api/client.js +937 -0
  12. package/dist/api/client.js.map +1 -0
  13. package/dist/api/contracts.d.ts +345 -0
  14. package/dist/api/contracts.d.ts.map +1 -0
  15. package/dist/api/contracts.js +976 -0
  16. package/dist/api/contracts.js.map +1 -0
  17. package/dist/api/execution-workspaces.d.ts +17 -0
  18. package/dist/api/execution-workspaces.d.ts.map +1 -0
  19. package/dist/api/execution-workspaces.js +46 -0
  20. package/dist/api/execution-workspaces.js.map +1 -0
  21. package/dist/api/http.d.ts +76 -0
  22. package/dist/api/http.d.ts.map +1 -0
  23. package/dist/api/http.js +838 -0
  24. package/dist/api/http.js.map +1 -0
  25. package/dist/api/managed-executions.d.ts +37 -0
  26. package/dist/api/managed-executions.d.ts.map +1 -0
  27. package/dist/api/managed-executions.js +80 -0
  28. package/dist/api/managed-executions.js.map +1 -0
  29. package/dist/api/observer-v2-schema.d.ts +206 -0
  30. package/dist/api/observer-v2-schema.d.ts.map +1 -0
  31. package/dist/api/observer-v2-schema.js +264 -0
  32. package/dist/api/observer-v2-schema.js.map +1 -0
  33. package/dist/api/observer-v2.d.ts +33 -0
  34. package/dist/api/observer-v2.d.ts.map +1 -0
  35. package/dist/api/observer-v2.js +60 -0
  36. package/dist/api/observer-v2.js.map +1 -0
  37. package/dist/api/owner-observe-grants-v2-schema.d.ts +678 -0
  38. package/dist/api/owner-observe-grants-v2-schema.d.ts.map +1 -0
  39. package/dist/api/owner-observe-grants-v2-schema.js +887 -0
  40. package/dist/api/owner-observe-grants-v2-schema.js.map +1 -0
  41. package/dist/api/owner-observe-grants-v2.d.ts +268 -0
  42. package/dist/api/owner-observe-grants-v2.d.ts.map +1 -0
  43. package/dist/api/owner-observe-grants-v2.js +604 -0
  44. package/dist/api/owner-observe-grants-v2.js.map +1 -0
  45. package/dist/api/provider-v2-schema.d.ts +293 -0
  46. package/dist/api/provider-v2-schema.d.ts.map +1 -0
  47. package/dist/api/provider-v2-schema.js +381 -0
  48. package/dist/api/provider-v2-schema.js.map +1 -0
  49. package/dist/api/provider-v2.d.ts +55 -0
  50. package/dist/api/provider-v2.d.ts.map +1 -0
  51. package/dist/api/provider-v2.js +54 -0
  52. package/dist/api/provider-v2.js.map +1 -0
  53. package/dist/api/remote-workspace.d.ts +29 -0
  54. package/dist/api/remote-workspace.d.ts.map +1 -0
  55. package/dist/api/remote-workspace.js +62 -0
  56. package/dist/api/remote-workspace.js.map +1 -0
  57. package/dist/api/supervisor-live-update.d.ts +248 -0
  58. package/dist/api/supervisor-live-update.d.ts.map +1 -0
  59. package/dist/api/supervisor-live-update.js +434 -0
  60. package/dist/api/supervisor-live-update.js.map +1 -0
  61. package/dist/api/terminal-reason.d.ts +5 -0
  62. package/dist/api/terminal-reason.d.ts.map +1 -0
  63. package/dist/api/terminal-reason.js +12 -0
  64. package/dist/api/terminal-reason.js.map +1 -0
  65. package/dist/auth/browser-handoff.d.ts +59 -0
  66. package/dist/auth/browser-handoff.d.ts.map +1 -0
  67. package/dist/auth/browser-handoff.js +33 -0
  68. package/dist/auth/browser-handoff.js.map +1 -0
  69. package/dist/auth/browser.d.ts +11 -0
  70. package/dist/auth/browser.d.ts.map +1 -0
  71. package/dist/auth/browser.js +47 -0
  72. package/dist/auth/browser.js.map +1 -0
  73. package/dist/auth/human-client.d.ts +39 -0
  74. package/dist/auth/human-client.d.ts.map +1 -0
  75. package/dist/auth/human-client.js +66 -0
  76. package/dist/auth/human-client.js.map +1 -0
  77. package/dist/auth/human-contracts.d.ts +52 -0
  78. package/dist/auth/human-contracts.d.ts.map +1 -0
  79. package/dist/auth/human-contracts.js +229 -0
  80. package/dist/auth/human-contracts.js.map +1 -0
  81. package/dist/auth/human-session.d.ts +48 -0
  82. package/dist/auth/human-session.d.ts.map +1 -0
  83. package/dist/auth/human-session.js +902 -0
  84. package/dist/auth/human-session.js.map +1 -0
  85. package/dist/auth/onboarding-state.d.ts +31 -0
  86. package/dist/auth/onboarding-state.d.ts.map +1 -0
  87. package/dist/auth/onboarding-state.js +52 -0
  88. package/dist/auth/onboarding-state.js.map +1 -0
  89. package/dist/auth/pkce.d.ts +15 -0
  90. package/dist/auth/pkce.d.ts.map +1 -0
  91. package/dist/auth/pkce.js +19 -0
  92. package/dist/auth/pkce.js.map +1 -0
  93. package/dist/bin/cuna.d.ts +3 -0
  94. package/dist/bin/cuna.d.ts.map +1 -0
  95. package/dist/bin/cuna.js +4 -0
  96. package/dist/bin/cuna.js.map +1 -0
  97. package/dist/build-identity.d.ts +20 -0
  98. package/dist/build-identity.d.ts.map +1 -0
  99. package/dist/build-identity.js +77 -0
  100. package/dist/build-identity.js.map +1 -0
  101. package/dist/cli/command-help.d.ts +9 -0
  102. package/dist/cli/command-help.d.ts.map +1 -0
  103. package/dist/cli/command-help.js +324 -0
  104. package/dist/cli/command-help.js.map +1 -0
  105. package/dist/cli/help.d.ts +40 -0
  106. package/dist/cli/help.d.ts.map +1 -0
  107. package/dist/cli/help.js +256 -0
  108. package/dist/cli/help.js.map +1 -0
  109. package/dist/cli/output.d.ts +28 -0
  110. package/dist/cli/output.d.ts.map +1 -0
  111. package/dist/cli/output.js +95 -0
  112. package/dist/cli/output.js.map +1 -0
  113. package/dist/cli/parser.d.ts +65 -0
  114. package/dist/cli/parser.d.ts.map +1 -0
  115. package/dist/cli/parser.js +294 -0
  116. package/dist/cli/parser.js.map +1 -0
  117. package/dist/cli/process-entrypoint.d.ts +18 -0
  118. package/dist/cli/process-entrypoint.d.ts.map +1 -0
  119. package/dist/cli/process-entrypoint.js +26 -0
  120. package/dist/cli/process-entrypoint.js.map +1 -0
  121. package/dist/cli/run.d.ts +114 -0
  122. package/dist/cli/run.d.ts.map +1 -0
  123. package/dist/cli/run.js +1969 -0
  124. package/dist/cli/run.js.map +1 -0
  125. package/dist/commands/commands.d.ts +74 -0
  126. package/dist/commands/commands.d.ts.map +1 -0
  127. package/dist/commands/commands.js +2814 -0
  128. package/dist/commands/commands.js.map +1 -0
  129. package/dist/config/config.d.ts +86 -0
  130. package/dist/config/config.d.ts.map +1 -0
  131. package/dist/config/config.js +323 -0
  132. package/dist/config/config.js.map +1 -0
  133. package/dist/config/infra-contract-witness.d.ts +29 -0
  134. package/dist/config/infra-contract-witness.d.ts.map +1 -0
  135. package/dist/config/infra-contract-witness.js +30 -0
  136. package/dist/config/infra-contract-witness.js.map +1 -0
  137. package/dist/core/browser-url.d.ts +2 -0
  138. package/dist/core/browser-url.d.ts.map +1 -0
  139. package/dist/core/browser-url.js +20 -0
  140. package/dist/core/browser-url.js.map +1 -0
  141. package/dist/core/deployed-wire-compatibility.d.ts +15 -0
  142. package/dist/core/deployed-wire-compatibility.d.ts.map +1 -0
  143. package/dist/core/deployed-wire-compatibility.js +15 -0
  144. package/dist/core/deployed-wire-compatibility.js.map +1 -0
  145. package/dist/core/errors.d.ts +59 -0
  146. package/dist/core/errors.d.ts.map +1 -0
  147. package/dist/core/errors.js +82 -0
  148. package/dist/core/errors.js.map +1 -0
  149. package/dist/core/exit-codes.d.ts +68 -0
  150. package/dist/core/exit-codes.d.ts.map +1 -0
  151. package/dist/core/exit-codes.js +84 -0
  152. package/dist/core/exit-codes.js.map +1 -0
  153. package/dist/core/instant.d.ts +60 -0
  154. package/dist/core/instant.d.ts.map +1 -0
  155. package/dist/core/instant.js +90 -0
  156. package/dist/core/instant.js.map +1 -0
  157. package/dist/core/namespace.d.ts +171 -0
  158. package/dist/core/namespace.d.ts.map +1 -0
  159. package/dist/core/namespace.js +227 -0
  160. package/dist/core/namespace.js.map +1 -0
  161. package/dist/core/observation-budget.d.ts +185 -0
  162. package/dist/core/observation-budget.d.ts.map +1 -0
  163. package/dist/core/observation-budget.js +209 -0
  164. package/dist/core/observation-budget.js.map +1 -0
  165. package/dist/core/product-web.d.ts +81 -0
  166. package/dist/core/product-web.d.ts.map +1 -0
  167. package/dist/core/product-web.js +87 -0
  168. package/dist/core/product-web.js.map +1 -0
  169. package/dist/core/validation.d.ts +90 -0
  170. package/dist/core/validation.d.ts.map +1 -0
  171. package/dist/core/validation.js +199 -0
  172. package/dist/core/validation.js.map +1 -0
  173. package/dist/credentials/contracts.d.ts +82 -0
  174. package/dist/credentials/contracts.d.ts.map +1 -0
  175. package/dist/credentials/contracts.js +2 -0
  176. package/dist/credentials/contracts.js.map +1 -0
  177. package/dist/credentials/errors.d.ts +19 -0
  178. package/dist/credentials/errors.d.ts.map +1 -0
  179. package/dist/credentials/errors.js +16 -0
  180. package/dist/credentials/errors.js.map +1 -0
  181. package/dist/credentials/index.d.ts +6 -0
  182. package/dist/credentials/index.d.ts.map +1 -0
  183. package/dist/credentials/index.js +6 -0
  184. package/dist/credentials/index.js.map +1 -0
  185. package/dist/credentials/local-session.d.ts +101 -0
  186. package/dist/credentials/local-session.d.ts.map +1 -0
  187. package/dist/credentials/local-session.js +839 -0
  188. package/dist/credentials/local-session.js.map +1 -0
  189. package/dist/credentials/secret-material.d.ts +17 -0
  190. package/dist/credentials/secret-material.d.ts.map +1 -0
  191. package/dist/credentials/secret-material.js +49 -0
  192. package/dist/credentials/secret-material.js.map +1 -0
  193. package/dist/credentials/vault.d.ts +41 -0
  194. package/dist/credentials/vault.d.ts.map +1 -0
  195. package/dist/credentials/vault.js +719 -0
  196. package/dist/credentials/vault.js.map +1 -0
  197. package/dist/daemon/endpoint.d.ts +29 -0
  198. package/dist/daemon/endpoint.d.ts.map +1 -0
  199. package/dist/daemon/endpoint.js +66 -0
  200. package/dist/daemon/endpoint.js.map +1 -0
  201. package/dist/daemon/journal.d.ts +62 -0
  202. package/dist/daemon/journal.d.ts.map +1 -0
  203. package/dist/daemon/journal.js +299 -0
  204. package/dist/daemon/journal.js.map +1 -0
  205. package/dist/daemon/lease.d.ts +25 -0
  206. package/dist/daemon/lease.d.ts.map +1 -0
  207. package/dist/daemon/lease.js +94 -0
  208. package/dist/daemon/lease.js.map +1 -0
  209. package/dist/daemon/lifecycle.d.ts +14 -0
  210. package/dist/daemon/lifecycle.d.ts.map +1 -0
  211. package/dist/daemon/lifecycle.js +29 -0
  212. package/dist/daemon/lifecycle.js.map +1 -0
  213. package/dist/daemon/protocol.d.ts +65 -0
  214. package/dist/daemon/protocol.d.ts.map +1 -0
  215. package/dist/daemon/protocol.js +194 -0
  216. package/dist/daemon/protocol.js.map +1 -0
  217. package/dist/daemon/supervisor.d.ts +29 -0
  218. package/dist/daemon/supervisor.d.ts.map +1 -0
  219. package/dist/daemon/supervisor.js +87 -0
  220. package/dist/daemon/supervisor.js.map +1 -0
  221. package/dist/daemon/views.d.ts +31 -0
  222. package/dist/daemon/views.d.ts.map +1 -0
  223. package/dist/daemon/views.js +86 -0
  224. package/dist/daemon/views.js.map +1 -0
  225. package/dist/index.d.ts +38 -0
  226. package/dist/index.d.ts.map +1 -0
  227. package/dist/index.js +38 -0
  228. package/dist/index.js.map +1 -0
  229. package/dist/journey/api-effects.d.ts +59 -0
  230. package/dist/journey/api-effects.d.ts.map +1 -0
  231. package/dist/journey/api-effects.js +386 -0
  232. package/dist/journey/api-effects.js.map +1 -0
  233. package/dist/journey/derived-identity.d.ts +91 -0
  234. package/dist/journey/derived-identity.d.ts.map +1 -0
  235. package/dist/journey/derived-identity.js +123 -0
  236. package/dist/journey/derived-identity.js.map +1 -0
  237. package/dist/journey/index.d.ts +6 -0
  238. package/dist/journey/index.d.ts.map +1 -0
  239. package/dist/journey/index.js +6 -0
  240. package/dist/journey/index.js.map +1 -0
  241. package/dist/journey/intent.d.ts +36 -0
  242. package/dist/journey/intent.d.ts.map +1 -0
  243. package/dist/journey/intent.js +191 -0
  244. package/dist/journey/intent.js.map +1 -0
  245. package/dist/journey/orchestrator.d.ts +140 -0
  246. package/dist/journey/orchestrator.d.ts.map +1 -0
  247. package/dist/journey/orchestrator.js +415 -0
  248. package/dist/journey/orchestrator.js.map +1 -0
  249. package/dist/journey/provider-launch-intent.d.ts +12 -0
  250. package/dist/journey/provider-launch-intent.d.ts.map +1 -0
  251. package/dist/journey/provider-launch-intent.js +40 -0
  252. package/dist/journey/provider-launch-intent.js.map +1 -0
  253. package/dist/journey/remote-workspace.d.ts +34 -0
  254. package/dist/journey/remote-workspace.d.ts.map +1 -0
  255. package/dist/journey/remote-workspace.js +91 -0
  256. package/dist/journey/remote-workspace.js.map +1 -0
  257. package/dist/journey/root-entry.d.ts +56 -0
  258. package/dist/journey/root-entry.d.ts.map +1 -0
  259. package/dist/journey/root-entry.js +19 -0
  260. package/dist/journey/root-entry.js.map +1 -0
  261. package/dist/journey/selection.d.ts +165 -0
  262. package/dist/journey/selection.d.ts.map +1 -0
  263. package/dist/journey/selection.js +565 -0
  264. package/dist/journey/selection.js.map +1 -0
  265. package/dist/journey/session-failure.d.ts +4 -0
  266. package/dist/journey/session-failure.d.ts.map +1 -0
  267. package/dist/journey/session-failure.js +28 -0
  268. package/dist/journey/session-failure.js.map +1 -0
  269. package/dist/journey/workspace-effects.d.ts +30 -0
  270. package/dist/journey/workspace-effects.d.ts.map +1 -0
  271. package/dist/journey/workspace-effects.js +348 -0
  272. package/dist/journey/workspace-effects.js.map +1 -0
  273. package/dist/local-actions/broker.d.ts +32 -0
  274. package/dist/local-actions/broker.d.ts.map +1 -0
  275. package/dist/local-actions/broker.js +400 -0
  276. package/dist/local-actions/broker.js.map +1 -0
  277. package/dist/local-actions/browser-action.d.ts +78 -0
  278. package/dist/local-actions/browser-action.d.ts.map +1 -0
  279. package/dist/local-actions/browser-action.js +307 -0
  280. package/dist/local-actions/browser-action.js.map +1 -0
  281. package/dist/local-actions/callback-relay.d.ts +45 -0
  282. package/dist/local-actions/callback-relay.d.ts.map +1 -0
  283. package/dist/local-actions/callback-relay.js +265 -0
  284. package/dist/local-actions/callback-relay.js.map +1 -0
  285. package/dist/local-actions/clipboard.d.ts +3 -0
  286. package/dist/local-actions/clipboard.d.ts.map +1 -0
  287. package/dist/local-actions/clipboard.js +18 -0
  288. package/dist/local-actions/clipboard.js.map +1 -0
  289. package/dist/local-actions/contracts.d.ts +63 -0
  290. package/dist/local-actions/contracts.d.ts.map +1 -0
  291. package/dist/local-actions/contracts.js +18 -0
  292. package/dist/local-actions/contracts.js.map +1 -0
  293. package/dist/local-actions/desktop-presentation.d.ts +141 -0
  294. package/dist/local-actions/desktop-presentation.d.ts.map +1 -0
  295. package/dist/local-actions/desktop-presentation.js +253 -0
  296. package/dist/local-actions/desktop-presentation.js.map +1 -0
  297. package/dist/local-actions/device-selection.d.ts +43 -0
  298. package/dist/local-actions/device-selection.d.ts.map +1 -0
  299. package/dist/local-actions/device-selection.js +154 -0
  300. package/dist/local-actions/device-selection.js.map +1 -0
  301. package/dist/local-actions/executor.d.ts +49 -0
  302. package/dist/local-actions/executor.d.ts.map +1 -0
  303. package/dist/local-actions/executor.js +329 -0
  304. package/dist/local-actions/executor.js.map +1 -0
  305. package/dist/local-actions/file-transfers.d.ts +141 -0
  306. package/dist/local-actions/file-transfers.d.ts.map +1 -0
  307. package/dist/local-actions/file-transfers.js +446 -0
  308. package/dist/local-actions/file-transfers.js.map +1 -0
  309. package/dist/local-actions/foreground-notifications.d.ts +45 -0
  310. package/dist/local-actions/foreground-notifications.d.ts.map +1 -0
  311. package/dist/local-actions/foreground-notifications.js +163 -0
  312. package/dist/local-actions/foreground-notifications.js.map +1 -0
  313. package/dist/local-actions/git-signing.d.ts +39 -0
  314. package/dist/local-actions/git-signing.d.ts.map +1 -0
  315. package/dist/local-actions/git-signing.js +135 -0
  316. package/dist/local-actions/git-signing.js.map +1 -0
  317. package/dist/local-actions/index.d.ts +19 -0
  318. package/dist/local-actions/index.d.ts.map +1 -0
  319. package/dist/local-actions/index.js +19 -0
  320. package/dist/local-actions/index.js.map +1 -0
  321. package/dist/local-actions/local-service-actions.d.ts +87 -0
  322. package/dist/local-actions/local-service-actions.d.ts.map +1 -0
  323. package/dist/local-actions/local-service-actions.js +347 -0
  324. package/dist/local-actions/local-service-actions.js.map +1 -0
  325. package/dist/local-actions/loopback.d.ts +5 -0
  326. package/dist/local-actions/loopback.d.ts.map +1 -0
  327. package/dist/local-actions/loopback.js +15 -0
  328. package/dist/local-actions/loopback.js.map +1 -0
  329. package/dist/local-actions/policy-store.d.ts +7 -0
  330. package/dist/local-actions/policy-store.d.ts.map +1 -0
  331. package/dist/local-actions/policy-store.js +70 -0
  332. package/dist/local-actions/policy-store.js.map +1 -0
  333. package/dist/local-actions/policy.d.ts +21 -0
  334. package/dist/local-actions/policy.d.ts.map +1 -0
  335. package/dist/local-actions/policy.js +43 -0
  336. package/dist/local-actions/policy.js.map +1 -0
  337. package/dist/local-actions/private-port-forward.d.ts +36 -0
  338. package/dist/local-actions/private-port-forward.d.ts.map +1 -0
  339. package/dist/local-actions/private-port-forward.js +154 -0
  340. package/dist/local-actions/private-port-forward.js.map +1 -0
  341. package/dist/local-actions/provider-mcp-config.d.ts +101 -0
  342. package/dist/local-actions/provider-mcp-config.d.ts.map +1 -0
  343. package/dist/local-actions/provider-mcp-config.js +166 -0
  344. package/dist/local-actions/provider-mcp-config.js.map +1 -0
  345. package/dist/local-actions/providers.d.ts +12 -0
  346. package/dist/local-actions/providers.d.ts.map +1 -0
  347. package/dist/local-actions/providers.js +42 -0
  348. package/dist/local-actions/providers.js.map +1 -0
  349. package/dist/local-actions/schemas.d.ts +4 -0
  350. package/dist/local-actions/schemas.d.ts.map +1 -0
  351. package/dist/local-actions/schemas.js +314 -0
  352. package/dist/local-actions/schemas.js.map +1 -0
  353. package/dist/local-actions/sensitive-consent.d.ts +32 -0
  354. package/dist/local-actions/sensitive-consent.d.ts.map +1 -0
  355. package/dist/local-actions/sensitive-consent.js +47 -0
  356. package/dist/local-actions/sensitive-consent.js.map +1 -0
  357. package/dist/machines/command-launch.d.ts +17 -0
  358. package/dist/machines/command-launch.d.ts.map +1 -0
  359. package/dist/machines/command-launch.js +52 -0
  360. package/dist/machines/command-launch.js.map +1 -0
  361. package/dist/machines/execution-receipt.d.ts +18 -0
  362. package/dist/machines/execution-receipt.d.ts.map +1 -0
  363. package/dist/machines/execution-receipt.js +87 -0
  364. package/dist/machines/execution-receipt.js.map +1 -0
  365. package/dist/machines/executions-screen.d.ts +6 -0
  366. package/dist/machines/executions-screen.d.ts.map +1 -0
  367. package/dist/machines/executions-screen.js +410 -0
  368. package/dist/machines/executions-screen.js.map +1 -0
  369. package/dist/machines/explorer.d.ts +75 -0
  370. package/dist/machines/explorer.d.ts.map +1 -0
  371. package/dist/machines/explorer.js +1726 -0
  372. package/dist/machines/explorer.js.map +1 -0
  373. package/dist/machines/live-supervisor-update.d.ts +325 -0
  374. package/dist/machines/live-supervisor-update.d.ts.map +1 -0
  375. package/dist/machines/live-supervisor-update.js +513 -0
  376. package/dist/machines/live-supervisor-update.js.map +1 -0
  377. package/dist/machines/machine-first.d.ts +123 -0
  378. package/dist/machines/machine-first.d.ts.map +1 -0
  379. package/dist/machines/machine-first.js +119 -0
  380. package/dist/machines/machine-first.js.map +1 -0
  381. package/dist/machines/opencode-supervisor.d.ts +51 -0
  382. package/dist/machines/opencode-supervisor.d.ts.map +1 -0
  383. package/dist/machines/opencode-supervisor.js +124 -0
  384. package/dist/machines/opencode-supervisor.js.map +1 -0
  385. package/dist/machines/pagination.d.ts +4 -0
  386. package/dist/machines/pagination.d.ts.map +1 -0
  387. package/dist/machines/pagination.js +7 -0
  388. package/dist/machines/pagination.js.map +1 -0
  389. package/dist/machines/provider-availability.d.ts +42 -0
  390. package/dist/machines/provider-availability.d.ts.map +1 -0
  391. package/dist/machines/provider-availability.js +82 -0
  392. package/dist/machines/provider-availability.js.map +1 -0
  393. package/dist/machines/provider-screen.d.ts +12 -0
  394. package/dist/machines/provider-screen.d.ts.map +1 -0
  395. package/dist/machines/provider-screen.js +129 -0
  396. package/dist/machines/provider-screen.js.map +1 -0
  397. package/dist/machines/session-actionability.d.ts +86 -0
  398. package/dist/machines/session-actionability.d.ts.map +1 -0
  399. package/dist/machines/session-actionability.js +125 -0
  400. package/dist/machines/session-actionability.js.map +1 -0
  401. package/dist/machines/session-visibility.d.ts +139 -0
  402. package/dist/machines/session-visibility.d.ts.map +1 -0
  403. package/dist/machines/session-visibility.js +109 -0
  404. package/dist/machines/session-visibility.js.map +1 -0
  405. package/dist/platform/adapter.d.ts +62 -0
  406. package/dist/platform/adapter.d.ts.map +1 -0
  407. package/dist/platform/adapter.js +240 -0
  408. package/dist/platform/adapter.js.map +1 -0
  409. package/dist/platform/support.d.ts +12 -0
  410. package/dist/platform/support.d.ts.map +1 -0
  411. package/dist/platform/support.js +25 -0
  412. package/dist/platform/support.js.map +1 -0
  413. package/dist/pty/contracts.d.ts +45 -0
  414. package/dist/pty/contracts.d.ts.map +1 -0
  415. package/dist/pty/contracts.js +2 -0
  416. package/dist/pty/contracts.js.map +1 -0
  417. package/dist/pty/evidence-gate.d.ts +14 -0
  418. package/dist/pty/evidence-gate.d.ts.map +1 -0
  419. package/dist/pty/evidence-gate.js +35 -0
  420. package/dist/pty/evidence-gate.js.map +1 -0
  421. package/dist/pty/index.d.ts +5 -0
  422. package/dist/pty/index.d.ts.map +1 -0
  423. package/dist/pty/index.js +5 -0
  424. package/dist/pty/index.js.map +1 -0
  425. package/dist/pty/node-host-terminal.d.ts +14 -0
  426. package/dist/pty/node-host-terminal.d.ts.map +1 -0
  427. package/dist/pty/node-host-terminal.js +173 -0
  428. package/dist/pty/node-host-terminal.js.map +1 -0
  429. package/dist/pty/node-process.d.ts +26 -0
  430. package/dist/pty/node-process.d.ts.map +1 -0
  431. package/dist/pty/node-process.js +102 -0
  432. package/dist/pty/node-process.js.map +1 -0
  433. package/dist/runtime/api-terminal-control-plane.d.ts +7 -0
  434. package/dist/runtime/api-terminal-control-plane.d.ts.map +1 -0
  435. package/dist/runtime/api-terminal-control-plane.js +95 -0
  436. package/dist/runtime/api-terminal-control-plane.js.map +1 -0
  437. package/dist/runtime/backoff.d.ts +17 -0
  438. package/dist/runtime/backoff.d.ts.map +1 -0
  439. package/dist/runtime/backoff.js +61 -0
  440. package/dist/runtime/backoff.js.map +1 -0
  441. package/dist/runtime/boundary.d.ts +171 -0
  442. package/dist/runtime/boundary.d.ts.map +1 -0
  443. package/dist/runtime/boundary.js +1858 -0
  444. package/dist/runtime/boundary.js.map +1 -0
  445. package/dist/runtime/capability-gate.d.ts +25 -0
  446. package/dist/runtime/capability-gate.d.ts.map +1 -0
  447. package/dist/runtime/capability-gate.js +77 -0
  448. package/dist/runtime/capability-gate.js.map +1 -0
  449. package/dist/runtime/contracts.d.ts +25 -0
  450. package/dist/runtime/contracts.d.ts.map +1 -0
  451. package/dist/runtime/contracts.js +66 -0
  452. package/dist/runtime/contracts.js.map +1 -0
  453. package/dist/runtime/errors.d.ts +20 -0
  454. package/dist/runtime/errors.d.ts.map +1 -0
  455. package/dist/runtime/errors.js +22 -0
  456. package/dist/runtime/errors.js.map +1 -0
  457. package/dist/runtime/index.d.ts +9 -0
  458. package/dist/runtime/index.d.ts.map +1 -0
  459. package/dist/runtime/index.js +9 -0
  460. package/dist/runtime/index.js.map +1 -0
  461. package/dist/runtime/node-foreground-session.d.ts +50 -0
  462. package/dist/runtime/node-foreground-session.d.ts.map +1 -0
  463. package/dist/runtime/node-foreground-session.js +431 -0
  464. package/dist/runtime/node-foreground-session.js.map +1 -0
  465. package/dist/runtime/node-websocket-connector.d.ts +6 -0
  466. package/dist/runtime/node-websocket-connector.d.ts.map +1 -0
  467. package/dist/runtime/node-websocket-connector.js +344 -0
  468. package/dist/runtime/node-websocket-connector.js.map +1 -0
  469. package/dist/runtime/observer-screen.d.ts +6 -0
  470. package/dist/runtime/observer-screen.d.ts.map +1 -0
  471. package/dist/runtime/observer-screen.js +144 -0
  472. package/dist/runtime/observer-screen.js.map +1 -0
  473. package/dist/runtime/owner-grant-operations.d.ts +136 -0
  474. package/dist/runtime/owner-grant-operations.d.ts.map +1 -0
  475. package/dist/runtime/owner-grant-operations.js +216 -0
  476. package/dist/runtime/owner-grant-operations.js.map +1 -0
  477. package/dist/runtime/owner-grants-screen.d.ts +40 -0
  478. package/dist/runtime/owner-grants-screen.d.ts.map +1 -0
  479. package/dist/runtime/owner-grants-screen.js +987 -0
  480. package/dist/runtime/owner-grants-screen.js.map +1 -0
  481. package/dist/runtime/terminal-transport.d.ts +85 -0
  482. package/dist/runtime/terminal-transport.d.ts.map +1 -0
  483. package/dist/runtime/terminal-transport.js +152 -0
  484. package/dist/runtime/terminal-transport.js.map +1 -0
  485. package/dist/sync/continuous-sync-supervisor.d.ts +107 -0
  486. package/dist/sync/continuous-sync-supervisor.d.ts.map +1 -0
  487. package/dist/sync/continuous-sync-supervisor.js +1117 -0
  488. package/dist/sync/continuous-sync-supervisor.js.map +1 -0
  489. package/dist/sync/index.d.ts +9 -0
  490. package/dist/sync/index.d.ts.map +1 -0
  491. package/dist/sync/index.js +9 -0
  492. package/dist/sync/index.js.map +1 -0
  493. package/dist/sync/journal.d.ts +57 -0
  494. package/dist/sync/journal.d.ts.map +1 -0
  495. package/dist/sync/journal.js +685 -0
  496. package/dist/sync/journal.js.map +1 -0
  497. package/dist/sync/revisions.d.ts +118 -0
  498. package/dist/sync/revisions.d.ts.map +1 -0
  499. package/dist/sync/revisions.js +364 -0
  500. package/dist/sync/revisions.js.map +1 -0
  501. package/dist/sync/supervisor.d.ts +107 -0
  502. package/dist/sync/supervisor.d.ts.map +1 -0
  503. package/dist/sync/supervisor.js +246 -0
  504. package/dist/sync/supervisor.js.map +1 -0
  505. package/dist/sync/workspace-sync-client.d.ts +18 -0
  506. package/dist/sync/workspace-sync-client.d.ts.map +1 -0
  507. package/dist/sync/workspace-sync-client.js +150 -0
  508. package/dist/sync/workspace-sync-client.js.map +1 -0
  509. package/dist/sync/workspace-sync-coordinator.d.ts +76 -0
  510. package/dist/sync/workspace-sync-coordinator.d.ts.map +1 -0
  511. package/dist/sync/workspace-sync-coordinator.js +621 -0
  512. package/dist/sync/workspace-sync-coordinator.js.map +1 -0
  513. package/dist/sync/workspace-sync-product-service.d.ts +79 -0
  514. package/dist/sync/workspace-sync-product-service.d.ts.map +1 -0
  515. package/dist/sync/workspace-sync-product-service.js +398 -0
  516. package/dist/sync/workspace-sync-product-service.js.map +1 -0
  517. package/dist/sync/workspace-sync-protocol.d.ts +145 -0
  518. package/dist/sync/workspace-sync-protocol.d.ts.map +1 -0
  519. package/dist/sync/workspace-sync-protocol.js +347 -0
  520. package/dist/sync/workspace-sync-protocol.js.map +1 -0
  521. package/dist/terminal/appbar.d.ts +40 -0
  522. package/dist/terminal/appbar.d.ts.map +1 -0
  523. package/dist/terminal/appbar.js +55 -0
  524. package/dist/terminal/appbar.js.map +1 -0
  525. package/dist/terminal/cell-width.d.ts +3 -0
  526. package/dist/terminal/cell-width.d.ts.map +1 -0
  527. package/dist/terminal/cell-width.js +53 -0
  528. package/dist/terminal/cell-width.js.map +1 -0
  529. package/dist/terminal/codec.d.ts +107 -0
  530. package/dist/terminal/codec.d.ts.map +1 -0
  531. package/dist/terminal/codec.js +538 -0
  532. package/dist/terminal/codec.js.map +1 -0
  533. package/dist/terminal/foreground.d.ts +135 -0
  534. package/dist/terminal/foreground.d.ts.map +1 -0
  535. package/dist/terminal/foreground.js +2097 -0
  536. package/dist/terminal/foreground.js.map +1 -0
  537. package/dist/terminal/generated/terminal-wire-v1.d.ts +26 -0
  538. package/dist/terminal/generated/terminal-wire-v1.d.ts.map +1 -0
  539. package/dist/terminal/generated/terminal-wire-v1.js +27 -0
  540. package/dist/terminal/generated/terminal-wire-v1.js.map +1 -0
  541. package/dist/terminal/mode.d.ts +33 -0
  542. package/dist/terminal/mode.d.ts.map +1 -0
  543. package/dist/terminal/mode.js +99 -0
  544. package/dist/terminal/mode.js.map +1 -0
  545. package/dist/terminal/passthrough.d.ts +47 -0
  546. package/dist/terminal/passthrough.d.ts.map +1 -0
  547. package/dist/terminal/passthrough.js +666 -0
  548. package/dist/terminal/passthrough.js.map +1 -0
  549. package/dist/terminal/resume.d.ts +58 -0
  550. package/dist/terminal/resume.d.ts.map +1 -0
  551. package/dist/terminal/resume.js +185 -0
  552. package/dist/terminal/resume.js.map +1 -0
  553. package/dist/terminal/viewport.d.ts +93 -0
  554. package/dist/terminal/viewport.d.ts.map +1 -0
  555. package/dist/terminal/viewport.js +266 -0
  556. package/dist/terminal/viewport.js.map +1 -0
  557. package/dist/terminal/workbench.d.ts +32 -0
  558. package/dist/terminal/workbench.d.ts.map +1 -0
  559. package/dist/terminal/workbench.js +316 -0
  560. package/dist/terminal/workbench.js.map +1 -0
  561. package/dist/terminal/xterm-vte.d.ts +49 -0
  562. package/dist/terminal/xterm-vte.d.ts.map +1 -0
  563. package/dist/terminal/xterm-vte.js +602 -0
  564. package/dist/terminal/xterm-vte.js.map +1 -0
  565. package/dist/version.d.ts +3 -0
  566. package/dist/version.d.ts.map +1 -0
  567. package/dist/version.js +3 -0
  568. package/dist/version.js.map +1 -0
  569. package/dist/workspace/binding-path.d.ts +17 -0
  570. package/dist/workspace/binding-path.d.ts.map +1 -0
  571. package/dist/workspace/binding-path.js +91 -0
  572. package/dist/workspace/binding-path.js.map +1 -0
  573. package/dist/workspace/binding-store.d.ts +107 -0
  574. package/dist/workspace/binding-store.d.ts.map +1 -0
  575. package/dist/workspace/binding-store.js +783 -0
  576. package/dist/workspace/binding-store.js.map +1 -0
  577. package/dist/workspace/binding.d.ts +35 -0
  578. package/dist/workspace/binding.d.ts.map +1 -0
  579. package/dist/workspace/binding.js +70 -0
  580. package/dist/workspace/binding.js.map +1 -0
  581. package/dist/workspace/errors.d.ts +4 -0
  582. package/dist/workspace/errors.d.ts.map +1 -0
  583. package/dist/workspace/errors.js +19 -0
  584. package/dist/workspace/errors.js.map +1 -0
  585. package/dist/workspace/exclusion.d.ts +21 -0
  586. package/dist/workspace/exclusion.d.ts.map +1 -0
  587. package/dist/workspace/exclusion.js +243 -0
  588. package/dist/workspace/exclusion.js.map +1 -0
  589. package/dist/workspace/index.d.ts +8 -0
  590. package/dist/workspace/index.d.ts.map +1 -0
  591. package/dist/workspace/index.js +8 -0
  592. package/dist/workspace/index.js.map +1 -0
  593. package/dist/workspace/lifecycle.d.ts +56 -0
  594. package/dist/workspace/lifecycle.d.ts.map +1 -0
  595. package/dist/workspace/lifecycle.js +94 -0
  596. package/dist/workspace/lifecycle.js.map +1 -0
  597. package/dist/workspace/manifest.d.ts +47 -0
  598. package/dist/workspace/manifest.d.ts.map +1 -0
  599. package/dist/workspace/manifest.js +243 -0
  600. package/dist/workspace/manifest.js.map +1 -0
  601. package/dist/workspace/paths.d.ts +14 -0
  602. package/dist/workspace/paths.d.ts.map +1 -0
  603. package/dist/workspace/paths.js +67 -0
  604. package/dist/workspace/paths.js.map +1 -0
  605. package/dist/workspace/schema.d.ts +15 -0
  606. package/dist/workspace/schema.d.ts.map +1 -0
  607. package/dist/workspace/schema.js +33 -0
  608. package/dist/workspace/schema.js.map +1 -0
  609. package/dist/workspace/selection-screen.d.ts +4 -0
  610. package/dist/workspace/selection-screen.d.ts.map +1 -0
  611. package/dist/workspace/selection-screen.js +216 -0
  612. package/dist/workspace/selection-screen.js.map +1 -0
  613. package/dist/workspace/selection-service.d.ts +16 -0
  614. package/dist/workspace/selection-service.d.ts.map +1 -0
  615. package/dist/workspace/selection-service.js +65 -0
  616. package/dist/workspace/selection-service.js.map +1 -0
  617. package/node_modules/@xterm/headless/README.md +31 -0
  618. package/node_modules/@xterm/headless/lib-headless/xterm-headless.js +2 -0
  619. package/node_modules/@xterm/headless/lib-headless/xterm-headless.js.map +1 -0
  620. package/node_modules/@xterm/headless/lib-headless/xterm-headless.mjs +46 -0
  621. package/node_modules/@xterm/headless/lib-headless/xterm-headless.mjs.map +7 -0
  622. package/node_modules/@xterm/headless/package.json +29 -0
  623. package/node_modules/@xterm/headless/typings/xterm-headless.d.ts +1385 -0
  624. package/package.json +75 -0
@@ -0,0 +1,94 @@
1
+ export class LeaseError extends Error {
2
+ code;
3
+ constructor(code, message) {
4
+ super(message);
5
+ this.name = "LeaseError";
6
+ this.code = code;
7
+ }
8
+ }
9
+ export class FencedLeaseStore {
10
+ #clock;
11
+ #records = new Map();
12
+ #lastGeneration = new Map();
13
+ constructor(clock = Date.now) {
14
+ this.#clock = clock;
15
+ }
16
+ acquire(resourceId, ownerId, ttlMs) {
17
+ assertIdentifier(resourceId, "resourceId");
18
+ assertIdentifier(ownerId, "ownerId");
19
+ assertTtl(ttlMs);
20
+ const now = this.#clock();
21
+ const current = this.#records.get(resourceId);
22
+ if (current !== undefined && !current.released && current.expiresAt > now) {
23
+ if (current.ownerId === ownerId)
24
+ return snapshot(resourceId, current, now);
25
+ throw new LeaseError("lease_conflict", "Another writer holds the active lease.");
26
+ }
27
+ const generation = (this.#lastGeneration.get(resourceId) ?? 0) + 1;
28
+ const next = { ownerId, generation, acquiredAt: now, expiresAt: now + ttlMs, released: false };
29
+ this.#records.set(resourceId, next);
30
+ this.#lastGeneration.set(resourceId, generation);
31
+ return snapshot(resourceId, next, now);
32
+ }
33
+ renew(token, ttlMs) {
34
+ assertTtl(ttlMs);
35
+ const current = this.#assertCurrent(token);
36
+ const now = this.#clock();
37
+ if (current.expiresAt <= now) {
38
+ throw new LeaseError("lease_expired", "The writer lease has expired and must be reacquired.");
39
+ }
40
+ current.expiresAt = now + ttlMs;
41
+ return snapshot(token.resourceId, current, now);
42
+ }
43
+ release(token) {
44
+ const current = this.#assertCurrent(token);
45
+ const now = this.#clock();
46
+ if (current.expiresAt <= now) {
47
+ throw new LeaseError("lease_expired", "The writer lease expired before release.");
48
+ }
49
+ current.released = true;
50
+ return snapshot(token.resourceId, current, now);
51
+ }
52
+ assertWriter(token) {
53
+ const current = this.#assertCurrent(token);
54
+ if (current.expiresAt <= this.#clock()) {
55
+ throw new LeaseError("lease_expired", "The writer lease is no longer active.");
56
+ }
57
+ }
58
+ inspect(resourceId) {
59
+ const record = this.#records.get(resourceId);
60
+ return record === undefined ? undefined : snapshot(resourceId, record, this.#clock());
61
+ }
62
+ #assertCurrent(token) {
63
+ const current = this.#records.get(token.resourceId);
64
+ if (current === undefined ||
65
+ current.released ||
66
+ current.ownerId !== token.ownerId ||
67
+ current.generation !== token.generation) {
68
+ throw new LeaseError("stale_fence", "The writer fence is stale or no longer owns the resource.");
69
+ }
70
+ return current;
71
+ }
72
+ }
73
+ function snapshot(resourceId, record, now) {
74
+ const state = record.released ? "released" : record.expiresAt <= now ? "expired" : "active";
75
+ return Object.freeze({
76
+ resourceId,
77
+ ownerId: record.ownerId,
78
+ generation: record.generation,
79
+ state,
80
+ acquiredAt: record.acquiredAt,
81
+ expiresAt: record.expiresAt,
82
+ });
83
+ }
84
+ function assertIdentifier(value, name) {
85
+ if (value.length === 0 || value.length > 256 || value.includes("\0")) {
86
+ throw new LeaseError("invalid_lease", `${name} is invalid.`);
87
+ }
88
+ }
89
+ function assertTtl(ttlMs) {
90
+ if (!Number.isSafeInteger(ttlMs) || ttlMs < 100 || ttlMs > 5 * 60_000) {
91
+ throw new LeaseError("invalid_lease", "The lease TTL is outside the supported bounds.");
92
+ }
93
+ }
94
+ //# sourceMappingURL=lease.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lease.js","sourceRoot":"","sources":["../../src/daemon/lease.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export type DaemonLifecycleState = "absent" | "starting" | "ready" | "quiescing" | "degraded" | "reconciling" | "recovery_required" | "stopped";
2
+ export interface DaemonLifecycleSnapshot {
3
+ readonly state: DaemonLifecycleState;
4
+ readonly revision: number;
5
+ readonly observedAt: number;
6
+ readonly reason: string;
7
+ }
8
+ export declare class DaemonLifecycle {
9
+ #private;
10
+ constructor(now: number);
11
+ snapshot(): DaemonLifecycleSnapshot;
12
+ transition(state: DaemonLifecycleState, reason: string, now: number): DaemonLifecycleSnapshot;
13
+ }
14
+ //# sourceMappingURL=lifecycle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,UAAU,GACV,OAAO,GACP,WAAW,GACX,UAAU,GACV,aAAa,GACb,mBAAmB,GACnB,SAAS,CAAC;AAad,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;;gBAGd,GAAG,EAAE,MAAM;IAIvB,QAAQ,IAAI,uBAAuB;IAInC,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,uBAAuB;CAQ9F"}
@@ -0,0 +1,29 @@
1
+ const TRANSITIONS = Object.freeze({
2
+ absent: new Set(["starting"]),
3
+ starting: new Set(["ready", "recovery_required", "stopped"]),
4
+ ready: new Set(["quiescing", "degraded"]),
5
+ quiescing: new Set(["ready", "stopped", "recovery_required"]),
6
+ degraded: new Set(["reconciling", "quiescing", "recovery_required"]),
7
+ reconciling: new Set(["ready", "recovery_required", "quiescing"]),
8
+ recovery_required: new Set(["ready", "stopped"]),
9
+ stopped: new Set(["starting"]),
10
+ });
11
+ export class DaemonLifecycle {
12
+ #snapshot;
13
+ constructor(now) {
14
+ this.#snapshot = Object.freeze({ state: "absent", revision: 0, observedAt: now, reason: "not_started" });
15
+ }
16
+ snapshot() {
17
+ return this.#snapshot;
18
+ }
19
+ transition(state, reason, now) {
20
+ if (!TRANSITIONS[this.#snapshot.state].has(state)) {
21
+ throw new Error(`Illegal daemon lifecycle transition: ${this.#snapshot.state} -> ${state}`);
22
+ }
23
+ if (reason.length === 0 || reason.length > 128)
24
+ throw new Error("A bounded safe daemon lifecycle reason is required.");
25
+ this.#snapshot = Object.freeze({ state, revision: this.#snapshot.revision + 1, observedAt: now, reason });
26
+ return this.#snapshot;
27
+ }
28
+ }
29
+ //# sourceMappingURL=lifecycle.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/daemon/lifecycle.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,GAA8E,MAAM,CAAC,MAAM,CAAC;IAC3G,MAAM,EAAE,IAAI,GAAG,CAAuB,CAAC,UAAU,CAAC,CAAC;IACnD,QAAQ,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAClF,KAAK,EAAE,IAAI,GAAG,CAAuB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/D,SAAS,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACnF,QAAQ,EAAE,IAAI,GAAG,CAAuB,CAAC,aAAa,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAC1F,WAAW,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACvF,iBAAiB,EAAE,IAAI,GAAG,CAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,EAAE,IAAI,GAAG,CAAuB,CAAC,UAAU,CAAC,CAAC;CACrD,CAAC,CAAC;AASH,MAAM,OAAO,eAAe;IAC1B,SAAS,CAA0B;IAEnC,YAAY,GAAW;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAC3G,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,UAAU,CAAC,KAA2B,EAAE,MAAc,EAAE,GAAW;QACjE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,SAAS,CAAC,KAAK,OAAO,KAAK,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1G,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
@@ -0,0 +1,65 @@
1
+ export declare const DAEMON_PROTOCOL: "cuna.daemon.v1";
2
+ export declare const DAEMON_PROTOCOL_VERSION: 1;
3
+ export declare const MAX_IPC_FRAME_BYTES: number;
4
+ export declare const MAX_IPC_BUFFER_BYTES: number;
5
+ export declare const MAX_IPC_QUEUED_FRAMES = 64;
6
+ export declare const IPC_FRAME_TYPES: Readonly<{
7
+ readonly hello: 1;
8
+ readonly welcome: 2;
9
+ readonly request: 3;
10
+ readonly response: 4;
11
+ readonly event: 5;
12
+ readonly cancel: 6;
13
+ readonly heartbeat: 7;
14
+ readonly error: 8;
15
+ }>;
16
+ export type IpcFrameType = keyof typeof IPC_FRAME_TYPES;
17
+ export type IpcProtocolErrorCode = "invalid_magic" | "unsupported_version" | "oversize_frame" | "buffer_limit" | "queue_limit" | "unknown_critical_frame" | "malformed_frame" | "invalid_message";
18
+ export declare class IpcProtocolError extends Error {
19
+ readonly code: IpcProtocolErrorCode;
20
+ constructor(code: IpcProtocolErrorCode, message: string);
21
+ }
22
+ export interface IpcFrame {
23
+ readonly type: IpcFrameType;
24
+ readonly critical: boolean;
25
+ readonly payload: Uint8Array;
26
+ }
27
+ export interface DecodedIpcFrame extends IpcFrame {
28
+ readonly wireVersion: typeof DAEMON_PROTOCOL_VERSION;
29
+ }
30
+ export interface IpcHello {
31
+ readonly kind: "hello";
32
+ readonly minimumVersion: number;
33
+ readonly maximumVersion: number;
34
+ readonly clientInstanceId: string;
35
+ }
36
+ export interface IpcWelcome {
37
+ readonly kind: "welcome";
38
+ readonly selectedVersion: typeof DAEMON_PROTOCOL_VERSION;
39
+ readonly daemonInstanceId: string;
40
+ }
41
+ export interface IpcRequest {
42
+ readonly kind: "request";
43
+ readonly requestId: string;
44
+ readonly operation: "lease.acquire" | "lease.renew" | "lease.release" | "intent.record" | "intent.reconcile" | "view.open" | "view.select" | "view.close" | "supervisor.inspect";
45
+ readonly body: Readonly<Record<string, unknown>>;
46
+ }
47
+ export interface IpcResponse {
48
+ readonly kind: "response";
49
+ readonly requestId: string;
50
+ readonly outcome: "accepted" | "rejected" | "unknown" | "reconciling";
51
+ readonly body?: Readonly<Record<string, unknown>>;
52
+ readonly reason?: string;
53
+ }
54
+ export type IpcMessage = IpcHello | IpcWelcome | IpcRequest | IpcResponse;
55
+ export declare function encodeIpcFrame(frame: IpcFrame): Uint8Array;
56
+ export declare function encodeIpcMessage(message: IpcMessage): Uint8Array;
57
+ export declare function decodeIpcFrame(bytes: Uint8Array): DecodedIpcFrame | undefined;
58
+ export declare function decodeIpcMessage(frame: DecodedIpcFrame): IpcMessage;
59
+ export declare function negotiateDaemonProtocol(minimumVersion: number, maximumVersion: number): typeof DAEMON_PROTOCOL_VERSION;
60
+ export declare class IpcFrameDecoder {
61
+ #private;
62
+ push(chunk: Uint8Array): readonly DecodedIpcFrame[];
63
+ get bufferedBytes(): number;
64
+ }
65
+ //# sourceMappingURL=protocol.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,194 @@
1
+ import { TextDecoder, TextEncoder } from "node:util";
2
+ export const DAEMON_PROTOCOL = "cuna.daemon.v1";
3
+ export const DAEMON_PROTOCOL_VERSION = 1;
4
+ export const MAX_IPC_FRAME_BYTES = 1024 * 1024;
5
+ export const MAX_IPC_BUFFER_BYTES = MAX_IPC_FRAME_BYTES * 2;
6
+ export const MAX_IPC_QUEUED_FRAMES = 64;
7
+ const HEADER_BYTES = 12;
8
+ const MAGIC = Uint8Array.of(0x52, 0x49, 0x50, 0x43); // RIPC
9
+ const CRITICAL_FLAG = 0x01;
10
+ export const IPC_FRAME_TYPES = Object.freeze({
11
+ hello: 1,
12
+ welcome: 2,
13
+ request: 3,
14
+ response: 4,
15
+ event: 5,
16
+ cancel: 6,
17
+ heartbeat: 7,
18
+ error: 8,
19
+ });
20
+ const TYPE_NAMES = new Map(Object.entries(IPC_FRAME_TYPES).map(([name, code]) => [code, name]));
21
+ export class IpcProtocolError extends Error {
22
+ code;
23
+ constructor(code, message) {
24
+ super(message);
25
+ this.name = "IpcProtocolError";
26
+ this.code = code;
27
+ }
28
+ }
29
+ const encoder = new TextEncoder();
30
+ const decoder = new TextDecoder("utf-8", { fatal: true });
31
+ function frameTypeCode(type) {
32
+ return IPC_FRAME_TYPES[type];
33
+ }
34
+ export function encodeIpcFrame(frame) {
35
+ if (frame.payload.byteLength > MAX_IPC_FRAME_BYTES) {
36
+ throw new IpcProtocolError("oversize_frame", "The IPC payload exceeds the protocol limit.");
37
+ }
38
+ const bytes = new Uint8Array(HEADER_BYTES + frame.payload.byteLength);
39
+ bytes.set(MAGIC, 0);
40
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
41
+ view.setUint8(4, DAEMON_PROTOCOL_VERSION);
42
+ view.setUint8(5, frame.critical ? CRITICAL_FLAG : 0);
43
+ view.setUint16(6, frameTypeCode(frame.type), false);
44
+ view.setUint32(8, frame.payload.byteLength, false);
45
+ bytes.set(frame.payload, HEADER_BYTES);
46
+ return bytes;
47
+ }
48
+ export function encodeIpcMessage(message) {
49
+ const type = message.kind;
50
+ return encodeIpcFrame({ type, critical: true, payload: encoder.encode(JSON.stringify(message)) });
51
+ }
52
+ function hasMagic(bytes) {
53
+ return MAGIC.every((value, index) => bytes[index] === value);
54
+ }
55
+ function parseHeader(bytes) {
56
+ if (bytes.byteLength < HEADER_BYTES) {
57
+ throw new IpcProtocolError("malformed_frame", "The IPC frame header is incomplete.");
58
+ }
59
+ if (!hasMagic(bytes)) {
60
+ throw new IpcProtocolError("invalid_magic", "The IPC frame magic is invalid.");
61
+ }
62
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
63
+ if (view.getUint8(4) !== DAEMON_PROTOCOL_VERSION) {
64
+ throw new IpcProtocolError("unsupported_version", "The IPC wire version is unsupported.");
65
+ }
66
+ const flags = view.getUint8(5);
67
+ if ((flags & ~CRITICAL_FLAG) !== 0) {
68
+ throw new IpcProtocolError("malformed_frame", "The IPC frame contains unsupported flags.");
69
+ }
70
+ const length = view.getUint32(8, false);
71
+ if (length > MAX_IPC_FRAME_BYTES) {
72
+ throw new IpcProtocolError("oversize_frame", "The IPC payload exceeds the protocol limit.");
73
+ }
74
+ return { typeCode: view.getUint16(6, false), critical: (flags & CRITICAL_FLAG) !== 0, length };
75
+ }
76
+ export function decodeIpcFrame(bytes) {
77
+ const header = parseHeader(bytes);
78
+ if (bytes.byteLength !== HEADER_BYTES + header.length) {
79
+ throw new IpcProtocolError("malformed_frame", "The IPC frame length does not match its payload.");
80
+ }
81
+ const type = TYPE_NAMES.get(header.typeCode);
82
+ if (type === undefined) {
83
+ if (header.critical) {
84
+ throw new IpcProtocolError("unknown_critical_frame", "The IPC frame type is unknown and critical.");
85
+ }
86
+ return undefined;
87
+ }
88
+ return {
89
+ type,
90
+ critical: header.critical,
91
+ payload: bytes.slice(HEADER_BYTES),
92
+ wireVersion: DAEMON_PROTOCOL_VERSION,
93
+ };
94
+ }
95
+ function isRecord(value) {
96
+ return typeof value === "object" && value !== null && !Array.isArray(value);
97
+ }
98
+ function isSafeIdentifier(value) {
99
+ return typeof value === "string" && value.length >= 1 && value.length <= 128 && /^[A-Za-z0-9._:-]+$/u.test(value);
100
+ }
101
+ export function decodeIpcMessage(frame) {
102
+ let value;
103
+ try {
104
+ value = JSON.parse(decoder.decode(frame.payload));
105
+ }
106
+ catch {
107
+ throw new IpcProtocolError("invalid_message", "The IPC message is not valid UTF-8 JSON.");
108
+ }
109
+ if (!isRecord(value) || value.kind !== frame.type) {
110
+ throw new IpcProtocolError("invalid_message", "The IPC message kind does not match its frame type.");
111
+ }
112
+ switch (value.kind) {
113
+ case "hello":
114
+ if (!Number.isSafeInteger(value.minimumVersion) ||
115
+ !Number.isSafeInteger(value.maximumVersion) ||
116
+ !isSafeIdentifier(value.clientInstanceId)) {
117
+ throw new IpcProtocolError("invalid_message", "The IPC hello message is malformed.");
118
+ }
119
+ return value;
120
+ case "welcome":
121
+ if (value.selectedVersion !== DAEMON_PROTOCOL_VERSION || !isSafeIdentifier(value.daemonInstanceId)) {
122
+ throw new IpcProtocolError("invalid_message", "The IPC welcome message is malformed.");
123
+ }
124
+ return value;
125
+ case "request":
126
+ if (!isSafeIdentifier(value.requestId) || typeof value.operation !== "string" || !isRecord(value.body)) {
127
+ throw new IpcProtocolError("invalid_message", "The IPC request is malformed.");
128
+ }
129
+ if (!REQUEST_OPERATIONS.has(value.operation)) {
130
+ throw new IpcProtocolError("invalid_message", "The IPC request operation is not allowlisted.");
131
+ }
132
+ return value;
133
+ case "response":
134
+ if (!isSafeIdentifier(value.requestId) || !RESPONSE_OUTCOMES.has(String(value.outcome))) {
135
+ throw new IpcProtocolError("invalid_message", "The IPC response is malformed.");
136
+ }
137
+ return value;
138
+ default:
139
+ throw new IpcProtocolError("invalid_message", "This IPC message has no structured decoder.");
140
+ }
141
+ }
142
+ const REQUEST_OPERATIONS = new Set([
143
+ "lease.acquire",
144
+ "lease.renew",
145
+ "lease.release",
146
+ "intent.record",
147
+ "intent.reconcile",
148
+ "view.open",
149
+ "view.select",
150
+ "view.close",
151
+ "supervisor.inspect",
152
+ ]);
153
+ const RESPONSE_OUTCOMES = new Set(["accepted", "rejected", "unknown", "reconciling"]);
154
+ export function negotiateDaemonProtocol(minimumVersion, maximumVersion) {
155
+ if (!Number.isSafeInteger(minimumVersion) ||
156
+ !Number.isSafeInteger(maximumVersion) ||
157
+ minimumVersion > maximumVersion ||
158
+ minimumVersion > DAEMON_PROTOCOL_VERSION ||
159
+ maximumVersion < DAEMON_PROTOCOL_VERSION) {
160
+ throw new IpcProtocolError("unsupported_version", "No compatible daemon IPC protocol version exists.");
161
+ }
162
+ return DAEMON_PROTOCOL_VERSION;
163
+ }
164
+ export class IpcFrameDecoder {
165
+ #buffer = new Uint8Array(0);
166
+ push(chunk) {
167
+ if (chunk.byteLength + this.#buffer.byteLength > MAX_IPC_BUFFER_BYTES) {
168
+ throw new IpcProtocolError("buffer_limit", "The IPC receive buffer limit was exceeded.");
169
+ }
170
+ const joined = new Uint8Array(this.#buffer.byteLength + chunk.byteLength);
171
+ joined.set(this.#buffer, 0);
172
+ joined.set(chunk, this.#buffer.byteLength);
173
+ this.#buffer = joined;
174
+ const frames = [];
175
+ while (this.#buffer.byteLength >= HEADER_BYTES) {
176
+ const header = parseHeader(this.#buffer);
177
+ const frameLength = HEADER_BYTES + header.length;
178
+ if (this.#buffer.byteLength < frameLength)
179
+ break;
180
+ const decoded = decodeIpcFrame(this.#buffer.slice(0, frameLength));
181
+ this.#buffer = this.#buffer.slice(frameLength);
182
+ if (decoded !== undefined)
183
+ frames.push(decoded);
184
+ if (frames.length > MAX_IPC_QUEUED_FRAMES) {
185
+ throw new IpcProtocolError("queue_limit", "Too many IPC frames were decoded in one batch.");
186
+ }
187
+ }
188
+ return frames;
189
+ }
190
+ get bufferedBytes() {
191
+ return this.#buffer.byteLength;
192
+ }
193
+ }
194
+ //# sourceMappingURL=protocol.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/daemon/protocol.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ export type SupervisedProcessState = "starting" | "ready" | "running" | "terminating" | "exited" | "failed" | "terminated";
2
+ export interface ProcessIdentity {
3
+ readonly agentSessionId: string;
4
+ readonly processEpoch: string;
5
+ }
6
+ export interface ProcessSnapshot extends ProcessIdentity {
7
+ readonly state: SupervisedProcessState;
8
+ readonly operatingSystemPid?: number;
9
+ readonly startedAt: number;
10
+ readonly updatedAt: number;
11
+ readonly exitCode?: number;
12
+ readonly failureReason?: string;
13
+ }
14
+ export declare class SupervisorError extends Error {
15
+ readonly code: "duplicate_process" | "unknown_process" | "invalid_transition" | "identity_mismatch";
16
+ constructor(code: SupervisorError["code"], message: string);
17
+ }
18
+ export declare class ProcessSupervisorModel {
19
+ #private;
20
+ register(identity: ProcessIdentity, now: number, operatingSystemPid?: number): ProcessSnapshot;
21
+ transition(identity: ProcessIdentity, nextState: SupervisedProcessState, now: number, details?: {
22
+ readonly exitCode?: number;
23
+ readonly failureReason?: string;
24
+ }): ProcessSnapshot;
25
+ require(identity: ProcessIdentity): ProcessSnapshot;
26
+ list(): readonly ProcessSnapshot[];
27
+ }
28
+ export declare function isTerminal(state: SupervisedProcessState): boolean;
29
+ //# sourceMappingURL=supervisor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/daemon/supervisor.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,OAAO,GACP,SAAS,GACT,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;gBAExF,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK3D;AAYD,qBAAa,sBAAsB;;IAGjC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe;IAiB9F,UAAU,CACR,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,sBAAsB,EACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5E,eAAe;IAuBlB,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe;IAUnD,IAAI,IAAI,SAAS,eAAe,EAAE;CAGnC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAEjE"}
@@ -0,0 +1,87 @@
1
+ export class SupervisorError extends Error {
2
+ code;
3
+ constructor(code, message) {
4
+ super(message);
5
+ this.name = "SupervisorError";
6
+ this.code = code;
7
+ }
8
+ }
9
+ const TRANSITIONS = Object.freeze({
10
+ starting: new Set(["ready", "failed", "terminating"]),
11
+ ready: new Set(["running", "terminating", "exited", "failed"]),
12
+ running: new Set(["terminating", "exited", "failed"]),
13
+ terminating: new Set(["terminated", "failed"]),
14
+ exited: new Set(),
15
+ failed: new Set(),
16
+ terminated: new Set(),
17
+ });
18
+ export class ProcessSupervisorModel {
19
+ #processes = new Map();
20
+ register(identity, now, operatingSystemPid) {
21
+ assertIdentity(identity);
22
+ const current = this.#processes.get(identity.agentSessionId);
23
+ if (current !== undefined && !isTerminal(current.state)) {
24
+ throw new SupervisorError("duplicate_process", "An active process already exists for this AgentSession.");
25
+ }
26
+ const next = freezeSnapshot({
27
+ ...identity,
28
+ state: "starting",
29
+ ...(operatingSystemPid === undefined ? {} : { operatingSystemPid }),
30
+ startedAt: now,
31
+ updatedAt: now,
32
+ });
33
+ this.#processes.set(identity.agentSessionId, next);
34
+ return next;
35
+ }
36
+ transition(identity, nextState, now, details = {}) {
37
+ const current = this.require(identity);
38
+ if (current.state === nextState)
39
+ return current;
40
+ if (!TRANSITIONS[current.state].has(nextState)) {
41
+ throw new SupervisorError("invalid_transition", `Process cannot transition from ${current.state} to ${nextState}.`);
42
+ }
43
+ if ((nextState === "exited" || nextState === "terminated") && details.failureReason !== undefined) {
44
+ throw new SupervisorError("invalid_transition", "A successful terminal state cannot carry a failure reason.");
45
+ }
46
+ if (nextState === "failed" && (details.failureReason === undefined || details.failureReason.length === 0)) {
47
+ throw new SupervisorError("invalid_transition", "A failed process requires a safe reason class.");
48
+ }
49
+ const next = freezeSnapshot({
50
+ ...current,
51
+ state: nextState,
52
+ updatedAt: now,
53
+ ...(details.exitCode === undefined ? {} : { exitCode: details.exitCode }),
54
+ ...(details.failureReason === undefined ? {} : { failureReason: details.failureReason }),
55
+ });
56
+ this.#processes.set(identity.agentSessionId, next);
57
+ return next;
58
+ }
59
+ require(identity) {
60
+ const current = this.#processes.get(identity.agentSessionId);
61
+ if (current === undefined)
62
+ throw new SupervisorError("unknown_process", "The AgentSession process is not supervised.");
63
+ // A PID may be reused. Epoch equality, not PID equality, proves continuity.
64
+ if (current.processEpoch !== identity.processEpoch) {
65
+ throw new SupervisorError("identity_mismatch", "The process epoch does not match the supervised generation.");
66
+ }
67
+ return current;
68
+ }
69
+ list() {
70
+ return Object.freeze([...this.#processes.values()]);
71
+ }
72
+ }
73
+ export function isTerminal(state) {
74
+ return state === "exited" || state === "failed" || state === "terminated";
75
+ }
76
+ function assertIdentity(identity) {
77
+ if (identity.agentSessionId.length === 0 ||
78
+ identity.agentSessionId.length > 256 ||
79
+ identity.processEpoch.length === 0 ||
80
+ identity.processEpoch.length > 256) {
81
+ throw new SupervisorError("identity_mismatch", "The process identity is invalid.");
82
+ }
83
+ }
84
+ function freezeSnapshot(snapshot) {
85
+ return Object.freeze(snapshot);
86
+ }
87
+ //# sourceMappingURL=supervisor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/daemon/supervisor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ export interface SessionBinding {
2
+ readonly userId: string;
3
+ readonly machineId: string;
4
+ readonly agentSessionId: string;
5
+ readonly processEpoch: string;
6
+ readonly fencingGeneration: number;
7
+ }
8
+ export type LocalViewState = "active" | "navigation" | "detached";
9
+ export interface LocalClientView {
10
+ readonly viewId: string;
11
+ readonly binding: SessionBinding;
12
+ readonly state: LocalViewState;
13
+ readonly columns: number;
14
+ readonly rows: number;
15
+ }
16
+ export declare class ViewIsolationError extends Error {
17
+ readonly code: "duplicate_view" | "unknown_view" | "stale_fence" | "navigation_active" | "invalid_view";
18
+ constructor(code: ViewIsolationError["code"], message: string);
19
+ }
20
+ export declare class LocalClientViewRegistry {
21
+ #private;
22
+ open(input: LocalClientView): LocalClientView;
23
+ enterNavigation(viewId: string): LocalClientView;
24
+ leaveNavigation(viewId: string): LocalClientView;
25
+ resize(viewId: string, columns: number, rows: number): LocalClientView;
26
+ detach(viewId: string): LocalClientView;
27
+ routeInput(viewId: string, presentedFence: number): SessionBinding;
28
+ require(viewId: string): LocalClientView;
29
+ list(): readonly LocalClientView[];
30
+ }
31
+ //# sourceMappingURL=views.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/daemon/views.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,GAAG,aAAa,GAAG,mBAAmB,GAAG,cAAc,CAAC;gBAE5F,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK9D;AAED,qBAAa,uBAAuB;;IAGlC,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe;IAQ7C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIhD,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIhD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IAKtE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAIvC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc;IAYlE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAMxC,IAAI,IAAI,SAAS,eAAe,EAAE;CAWnC"}