morluto
9a18251426
Keep complete default delivery and exact filters. Select stable ID pages at the ledger owner before cloning, return filtered totals and continuation offsets, and preserve detached records through the shared session port. Validate public MCP paging, safe-integer edges, snapshot replay and converted JSON Schemas. Document the bounded Flameox workflow comparison and its token/CPU/latency measurement limits; no real model performance claim.
61 lines
3.6 KiB
Markdown
61 lines
3.6 KiB
Markdown
# Selected unknown retrieval
|
|
|
|
`list_unknowns` now accepts optional paging. Omitted limits still return all
|
|
matching heads. Selection happens before payload cloning in the ledger owner;
|
|
MCP returns complete selected records and the total matching count.
|
|
|
|
## Bounded workflow comparison
|
|
|
|
The task is to retrieve the first ten complete current unknown heads, in stable
|
|
ID order, from a session containing 200 heads. The complete-list workflow reads
|
|
all heads and selects ten locally. The selected-page workflow requests
|
|
`{"offset":0,"limit":10}`. Both use one real SDK MCP call through
|
|
`Client`/`InMemoryTransport`, with the same imported session and no provider.
|
|
All six executions returned identical selected records and the expected total.
|
|
|
|
These are two workflows on the candidate implementation, **not** a historical
|
|
before/after binary comparison. The candidate was built from `f09bb8a99` plus
|
|
the paging changes. Runtime file-table SHA-256 for the preserved complete-list
|
|
copy: `06a457dac90912dceba88f945573897372701f6c6b2e0934d7028023b4646648`.
|
|
Node 24.18.0, locked MCP SDK 2.3.1, tokenx 1.3.0, macOS arm64.
|
|
|
|
Flameox 0.2.9 ran three randomized paired blocks, seed 731, with a 30-second
|
|
and 1-GiB limit per execution. Each fresh process performed a first read and
|
|
five identical warm reads. The semantic oracle checked the selected answer
|
|
SHA-256, `c18d718a71323eb53712040b4b09ffebfc3497000d1ff8f58d57665638077310`.
|
|
Every execution and oracle passed.
|
|
|
|
| Measurement | Complete list | Selected page |
|
|
| ----------------------------------------- | ------------: | ------------: |
|
|
| Calls / errors per task | 1 / 0 | 1 / 0 |
|
|
| Serialized response bytes | 646,855 | 32,603 |
|
|
| Estimated request tokens | 12 | 21 |
|
|
| Estimated response tokens | 151,097 | 7,647 |
|
|
| Estimated full catalog tokens | 764,512 | 764,512 |
|
|
| Median first-read elapsed milliseconds | 1,084.05 | 1,082.65 |
|
|
| Median warm-read elapsed milliseconds | 3.943 | 0.426 |
|
|
| Median first-read CPU milliseconds | 1,333.23 | 1,328.47 |
|
|
| Median warm-read CPU milliseconds | 5.012 | 0.591 |
|
|
| Median whole-process elapsed milliseconds | 1,752.40 | 1,664.42 |
|
|
| Median peak process-family MiB | 598.59 | 554.09 |
|
|
|
|
Read timings include the MCP call and answer validation. First-read timings
|
|
exclude startup, imports, session preparation, handshake and catalog discovery;
|
|
the whole-process elapsed measurement includes those, all six reads, token
|
|
estimation and cleanup. Whole-process CPU was not measured. Peak RSS includes
|
|
preparation and imports; this workload has no child processes. Host caches were
|
|
not flushed. Three pairs and fifteen warm reads per workflow describe this
|
|
fixture only; they do not establish broad speed or memory improvements.
|
|
|
|
Token counts estimate serialized request, response and catalog JSON, including
|
|
both MCP response representations. They are not measured model tokens. Host
|
|
schema injection, prompts, reasoning, retries and actual agent behavior are
|
|
unmeasured. The full catalog cost is unchanged between these workflows and can
|
|
dominate a first task. Smaller selected delivery does not remove that cost.
|
|
|
|
Native Flameox evidence was preserved locally as
|
|
`14ea4c0ef6595a1b89645299d4e184a582d5e975f7916294d68c1f1b312608d0`,
|
|
analysis `f66e125179623591ce00b1ccf0d917c2e90512de55db1061269c042d65e1125d`.
|
|
An earlier 512-MiB capture exceeded its memory limit and is excluded from these
|
|
measurements. No production provider or model trial was run.
|