core: post the engine API for DAEMON review (pre-stage-7)

sami/vdm

The download entry point the AGENT-CORE brief asked for on day one and
that slipped. DAEMON has an RPC surface and a store and, until this is
agreed, nothing in velox::core to call.

vdm/task/download.hpp — DownloadSpec (the resolved subset DAEMON hands in:
absolute save_path, verbatim browser headers, requested segments/buffer,
optional probe_hint / checksum / auth, allow_resume), EngineState (the
CORE-owned subset of the wire TaskState), Progress / SegmentProgress,
DownloadCallbacks (on_progress <=4 Hz, on_state for every transition
incl. auto-pauses, on_auth_required, on_decision_needed, on_finished
last), DownloadHandle (pause/resume/cancel — idempotent per the ADR 0013
signature — plus provide_auth / decide / refresh_url, and synchronous
state()/progress() snapshots).

vdm/engine.hpp — Engine: start(spec, callbacks) -> handle, segment_budget()
(DAEMON's sched/ admission surface, ADR 0011), live connection.* setters,
a standalone probe() on the pool outside the segment budget.

core/docs/engine-api-m1.md — the review doc: field semantics, the state
machine, threading/lifetime rules (which thread callbacks arrive on, what
is legal from inside one, handle/engine lifetime), the shared-`paused`
idempotency contract as a signature, and five open questions for DAEMON.

Value types compile and are covered by api_compiles_test; Engine /
DownloadHandle bodies land in stage 8, built against whatever DAEMON
signs off here.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01HPPSGhiArbvQgwC2DNiURS

This commit is contained in:

sami

2026-09-10 15:39:25 +04:00

co-authored by

Claude Sonnet 5

parent 170bcfdb3e

commit d6cf1fe7dc

6 changed files with 538 additions and 3 deletions

									
										core/tests/CMakeLists.txt
									
		+1
		
												View File
												
				@@ -30,6 +30,7 @@ vdm_add_test(veloxcore_write_buffer_test io/write_buffer_test.cpp)

				vdm_add_test(veloxcore_veloxpart_test meta/veloxpart_test.cpp)

				vdm_add_test(veloxcore_segmenter_test segment/segmenter_test.cpp)

				vdm_add_test(veloxcore_budget_test segment/budget_test.cpp)

				vdm_add_test(veloxcore_engine_api_test task/api_compiles_test.cpp)

				set(_testserver ${CMAKE_SOURCE_DIR}/tools/testserver/testserver.py)

				foreach(net_it http_client probe)