Repository navigation
Expand file tree
/
Copy pathserver_job.lua
More file actions
553 lines (506 loc) · 17.6 KB
/
Copy pathserver_job.lua
File metadata and controls
553 lines (506 loc) · 17.6 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
local state = require('opencode.state')
local Promise = require('opencode.promise')
local opencode_server = require('opencode.opencode_server')
local port_mapping = require('opencode.port_mapping')
local log = require('opencode.log')
local config = require('opencode.config')
local util = require('opencode.util')
local auth = require('opencode.auth')
local legacy_server = require('opencode.protocols.v1.server')
local registry = require('opencode.protocols.registry')
local M = {}
local health_checked_at = setmetatable({}, { __mode = 'k' })
local generate_spawn_password
local connect_or_spawn_legacy_server
local function non_empty(value)
return type(value) == 'string' and value ~= '' and value or nil
end
local function password_file_path(path)
path = path or config.server.password_file
if path == nil or path == '' then
return nil
end
if type(path) ~= 'string' then
error('server.password_file must be a string')
end
return path
end
local function read_saved_password(path)
path = password_file_path(path)
if not path then
return nil
end
local stat = vim.uv.fs_stat(path)
if not stat then
return nil
end
if stat.type ~= 'file' or vim.fn.filereadable(path) ~= 1 then
error('server.password_file is not a readable file: ' .. path)
end
local permissions = vim.fn.getfperm(path)
if type(permissions) ~= 'string' or #permissions < 9 or permissions:sub(4, 9) ~= '------' then
error('server.password_file must be accessible only by its owner: ' .. path)
end
local ok, lines = pcall(vim.fn.readfile, path)
if not ok then
error('failed to read server.password_file: ' .. path)
end
local password = lines[1]
if not non_empty(password) then
error('server.password_file is empty: ' .. path)
end
return password
end
local function save_password(password, path)
path = password_file_path(path)
if not path then
return password
end
local ok, result = pcall(vim.fn.mkdir, vim.fn.fnamemodify(path, ':h'), 'p')
if not ok or result == -1 then
error('failed to create server.password_file directory: ' .. path)
end
local fd, open_error = vim.uv.fs_open(path, 'wx', 384)
if not fd then
if vim.uv.fs_stat(path) then
return read_saved_password(path)
end
error('failed to create server.password_file: ' .. tostring(open_error))
end
local payload = password .. '\n'
local written, write_error = vim.uv.fs_write(fd, payload, -1)
local synced, sync_error = vim.uv.fs_fsync(fd)
vim.uv.fs_close(fd)
if written ~= #payload or not synced then
error('failed to persist server.password_file: ' .. tostring(write_error or sync_error))
end
if vim.fn.setfperm(path, 'rw-------') ~= 1 then
error('failed to set server.password_file permissions: ' .. path)
end
return read_saved_password(path)
end
local function resolve_config_value(name)
local value = config.server[name]
if type(value) == 'function' then
local ok, resolved = pcall(value)
if not ok then
error(string.format('server.%s failed: %s', name, tostring(resolved)))
end
value = resolved
end
if value == nil or value == '' then
return nil
end
if type(value) ~= 'string' then
error(string.format('server.%s must resolve to a string', name))
end
return value
end
local function resolve_credential(generate_password, credential_file)
local configured_password = resolve_config_value('password')
local password = configured_password
if not password then
password = read_saved_password(credential_file)
end
password = password or non_empty(vim.env.OPENCODE_PASSWORD) or non_empty(vim.env.OPENCODE_SERVER_PASSWORD)
if not password and generate_password then
password = generate_spawn_password()
end
local path = password_file_path(credential_file)
if generate_password and password and path and not vim.uv.fs_stat(path) then
password = save_password(password, path)
end
return {
username = resolve_config_value('username') or non_empty(vim.env.OPENCODE_SERVER_USERNAME) or 'opencode',
password = password,
}
end
local function apply_probe(server, probe, acquired_pid)
server.protocol = probe.protocol
server.server_identity = {
version = probe.response.version,
pid = probe.response.pid or acquired_pid,
}
server.version = server.server_identity.version
return server
end
generate_spawn_password = function()
local seed = tostring(vim.uv.hrtime()) .. tostring(math.random())
return vim.fn.sha256(seed):sub(1, 32)
end
local function try_custom_server(server, timeout)
local probe = server:probe_connection(timeout * 1000)
return probe:and_then(function(probe_result)
return apply_probe(server, probe_result, server.custom_pid or (server.job and server.job.pid))
end)
end
--- @return number|nil port
local function resolve_port()
local custom_port = config.server.port or 'auto'
if custom_port ~= 'auto' then
return custom_port
end
if not config.server.spawn_command then
return port_mapping.find_any_existing_port()
end
local existing = port_mapping.find_port_for_directory(vim.fn.getcwd())
return existing or math.random(1024, 65535)
end
local function is_http_endpoint(value)
return value:match('^https?://[^%s]+$') ~= nil
end
local function wait_for_service_endpoint(command, timeout)
for _ = 1, math.max(1, math.floor(timeout / 100)) do
local url = command('service', 'status')
if url ~= 'starting' and url ~= 'stopped' then
return url
end
Promise.delay(100):await()
end
error('OpenCode service did not return an HTTP endpoint', 0)
end
local function probe_until_ready(server, timeout_ms, retry_transport)
local clock = vim.uv or vim.loop
local deadline = clock.now() + timeout_ms
return Promise.retry(
function()
return server:probe_connection(timeout_ms)
end,
math.max(1, math.floor(timeout_ms / 100)),
100,
function(err)
return retry_transport and type(err) == 'table' and err.kind == 'transport' and clock.now() < deadline
end
)
end
-- CLI capability selects the launcher only; authenticated health selects the protocol.
local try_native_service = Promise.async(function()
local timeout = (config.server.timeout or 5) * 1000
local function command(...)
local args = { config.opencode_executable, ... }
local ok, result = pcall(function()
return Promise.system(args, { text = true, timeout = timeout }):await()
end)
if not ok then
if args[2] == 'service' and args[3] == 'start' and type(result) == 'table' and result.code == 124 then
-- The service can outlive its launcher; discover its endpoint through status.
return ''
end
-- In particular, never include the password command's stdout in an error.
error('OpenCode command failed: ' .. table.concat(args, ' '), 0)
end
return vim.trim(result.stdout or ''), vim.trim(result.stderr or '')
end
local help, help_stderr = command('--help')
help = non_empty(help) or help_stderr
if help == '' then
error('OpenCode returned empty command help', 0)
end
if not help:match('\n%s*service%s+') then
return nil
end
local url = command('service', 'status')
local starting_service = url == 'stopped'
if starting_service then
url = command('service', 'start')
if not is_http_endpoint(url) then
url = wait_for_service_endpoint(command, timeout)
end
end
if not is_http_endpoint(url) then
error('OpenCode service did not return an HTTP endpoint', 0)
end
local password = command('service', 'get', 'password')
if password == '' then
error('OpenCode service did not return a credential', 0)
end
local server = opencode_server.from_custom(url)
server.credential = { username = 'opencode', password = password }
local probe = probe_until_ready(server, timeout, starting_service):await()
if probe.protocol ~= 'v2' then
error('OpenCode background service did not provide V2 health', 0)
end
apply_probe(server, probe)
server:mark_ready()
health_checked_at[server] = (vim.uv or vim.loop).now()
-- The native service owns its lifecycle and never enters plugin port bookkeeping.
state.jobs.set_server(server)
return server
end)
---Non-opencode backends own launch, health and shutdown; HTTP discovery below is skipped.
---@return OpencodeStartableAdapter|nil
local function backend_adapter()
local backend = config.backend
if backend == 'opencode' then
return nil
end
require('opencode.protocols.' .. backend .. '.connection')
local adapter = registry.get(backend)
if not adapter or not adapter.start_server then
error(string.format('backend %q cannot start a server', backend), 0)
end
---@cast adapter OpencodeStartableAdapter
return adapter
end
---@return Promise<OpencodeServer>
local function _start_server()
local adapter = backend_adapter()
if adapter then
return adapter.start_server():and_then(function(server)
state.jobs.set_server(server)
return server
end)
end
local promise = Promise.new()
local custom_url = config.server.url
if not custom_url then
if config.server.spawn_command then
connect_or_spawn_legacy_server(promise)
return promise
end
try_native_service()
:and_then(function(server)
if server then
promise:resolve(server)
else
connect_or_spawn_legacy_server(promise)
end
end)
:catch(function(err)
promise:reject(err)
end)
return promise
end
local custom_port = resolve_port(custom_url)
if not custom_port then
M.spawn_local_server(promise)
return promise
end
local base_url = string.format('%s:%d', util.normalize_url_protocol(custom_url), custom_port)
local timeout = config.server.timeout or 5
log.debug('ensure_server: trying custom server at %s (timeout=%ds)', base_url, timeout)
M.try_connect_to_custom_server(base_url, timeout, promise, custom_port, custom_url)
return promise
end
local pending_connection
local function has_recent_health_check(server, opts)
if not server or not server:is_ready() or (opts and opts.force_health_check) then
return false
end
local checked_at = health_checked_at[server]
local ttl = config.server.health_check_ttl_ms or 5000
return checked_at ~= nil and (vim.uv or vim.loop).now() - checked_at < ttl
end
local function validate_cached_server(server)
local ok, result = pcall(function()
return server:check_health():await()
end)
if state.opencode_server ~= server then
return false
end
if ok then
return result
end
if type(result) == 'table' and (result.kind == 'transport' or result.kind == 'identity_changed') then
return false
end
error(result, 0)
end
local function connect_ready_server()
local server = state.opencode_server
while server and server:is_ready() do
if validate_cached_server(server) then
return server
end
if state.opencode_server == server then
log.warn('ensure_server: cached server unavailable or replaced, reconnecting')
state.jobs.clear_server()
break
end
server = state.opencode_server
end
return _start_server():await()
end
---Ensure all callers share startup and health checks until the server is ready.
---@param opts? {force_health_check?: boolean}
---@return Promise<OpencodeServer>
function M.ensure_server(opts)
if pending_connection then
return pending_connection
end
if has_recent_health_check(state.opencode_server, opts) then
return Promise.new():resolve(state.opencode_server)
end
local connection = Promise.new()
pending_connection = connection
Promise.spawn(connect_ready_server)
:and_then(function(server)
health_checked_at[server] = (vim.uv or vim.loop).now()
pending_connection = nil
connection:resolve(server)
require('opencode.protocols.contract_check').check_async(server)
end)
:catch(function(err)
pending_connection = nil
connection:reject(err)
end)
return connection
end
local function publish_custom_server(server, server_pid)
server:mark_ready()
health_checked_at[server] = (vim.uv or vim.loop).now()
port_mapping.register(server.port, vim.fn.getcwd(), server_pid, server:can_release_process())
state.jobs.set_server(server)
return server
end
local function retry_connect(server, timeout, remaining)
return try_custom_server(server, timeout):catch(function(err)
if type(err) ~= 'table' or err.kind ~= 'transport' or remaining == 0 then
return Promise.new():reject(err)
end
return Promise.delay(config.server.retry_delay or 2000):and_then(function()
return retry_connect(server, timeout, remaining - 1)
end)
end)
end
---Reuse a configured legacy server before starting another `serve` process.
---@param promise Promise<OpencodeServer>
connect_or_spawn_legacy_server = function(promise)
local port = legacy_server.configured_port()
if not port then
M.spawn_local_server(promise)
return
end
local server = opencode_server.from_custom(legacy_server.endpoint(port), port)
local credential_ok, credential = pcall(resolve_credential, false, legacy_server.credential_file(port))
if not credential_ok then
promise:reject(credential)
return
end
server.credential = credential
local mapped_release = port_mapping.capture_process_release(port)
if mapped_release then
server:set_process_release(mapped_release)
end
try_custom_server(server, config.server.timeout or 5)
:and_then(function(ready_server)
publish_custom_server(ready_server, ready_server.server_identity.pid)
promise:resolve(ready_server)
end)
:catch(function(err)
if type(err) ~= 'table' or err.kind ~= 'transport' then
promise:reject(err)
return
end
M.spawn_local_server(promise, port)
end)
end
function M.try_connect_to_custom_server(base_url, timeout, promise, custom_port, custom_url)
local server = opencode_server.from_custom(base_url, custom_port)
local credential_ok, credential = pcall(resolve_credential, false)
if not credential_ok then
promise:reject(credential)
return
end
server.credential = credential
local mapped_release = port_mapping.capture_process_release(custom_port)
if mapped_release then
server:set_process_release(mapped_release)
end
try_custom_server(server, timeout)
:catch(function(err)
-- Only a transport failure can mean that an explicitly configured launcher is needed.
-- HTTP authentication and contract failures describe an existing server and must remain visible.
if type(err) ~= 'table' or err.kind ~= 'transport' then
return Promise.new():reject(err)
end
if not config.server.spawn_command then
return retry_connect(server, timeout, 5)
end
server.credential = resolve_credential(true)
local ok, result = pcall(config.server.spawn_command, custom_port, custom_url, auth.get_env(server.credential))
if not ok then
return Promise.new():reject(result)
end
server.custom_pid = type(result) == 'number' and result or nil
if config.server.auto_kill then
local kill_command = config.server.kill_command
local pid = server.custom_pid
if kill_command then
server:set_process_release(function()
kill_command(custom_port, custom_url)
end)
elseif pid then
server:set_process_release(function()
require('opencode.util').kill_pid(pid)
end)
end
end
return retry_connect(server, timeout, 3)
end)
:and_then(function(ready_server)
publish_custom_server(ready_server, ready_server.custom_pid)
promise:resolve(ready_server)
end)
:catch(function(err)
promise:reject(err)
end)
end
--- @param promise Promise<OpencodeServer>
--- @param port? number|string Optional custom port
--- @param hostname? string Optional custom hostname
function M.spawn_local_server(promise, port, hostname)
local server = opencode_server.new()
local credential_ok, credential = pcall(resolve_credential, true, legacy_server.credential_file(port))
if not credential_ok then
promise:reject(credential)
return
end
server.credential = credential
local cwd = vim.fn.getcwd()
local spawn_opts = {
cwd = cwd,
command = legacy_server.command(port, hostname),
auto_kill = config.server.auto_kill,
listening_url = legacy_server.listening_url,
on_ready = function(job, base_url)
local url_port = base_url:match(':(%d+)')
log.notify(string.format('Started local server at %s', base_url), vim.log.levels.INFO)
if url_port then
local port_num = tonumber(url_port)
if state.opencode_server == server then
state.jobs.set_server_port(port_num)
else
server.port = port_num
end
local server_pid = job and job.pid
log.debug(
'spawn_local_server: registered port %d for reference counting (server_pid=%s)',
port_num,
tostring(server_pid)
)
end
local probe = probe_until_ready(server, (config.server.timeout or 5) * 1000, true)
probe
:and_then(function(probe_result)
apply_probe(server, probe_result, server.job and server.job.pid)
publish_custom_server(server, server.job and server.job.pid)
promise:resolve(server)
end)
:catch(function(err)
log.notify(' Failed to start opencode server' .. vim.inspect(err), vim.log.levels.ERROR)
server:shutdown()
promise:reject(err)
end)
end,
on_error = function(err)
log.notify(' Failed to start opencode server' .. vim.inspect(err), vim.log.levels.ERROR)
promise:reject(err)
end,
on_exit = function(exit_opts)
promise:reject('Server exited')
end,
}
server:spawn(spawn_opts)
end
return M