Upstream sweep 2026-06-19: streaming downloads, preflight, CLI peers, node config

[JimCollinson]

Prose updates for the daily upstream sweep, tracking developer-facing surface changes in the ant-sdk 0.10.0, ant-client, and ant-node releases. Companion to the metadata-only sweep PR (claude/sweep-2026-06-19); the two PRs touch disjoint page sets. Opened as draft for prose review.

Upstream

• ant-sdk: e102df9b -> e56292325d
• ant-client: 84332e2d -> 4d0448458e
• ant-node: fb7494e84d -> c53665bf4d

Source artifacts inspected

• antd/openapi.yaml, antd/proto/antd/v1/data.proto, antd/proto/antd/v1/upload.proto, antd/src/rest/{mod,data,upload}.rs, antd/src/grpc/service.rs, antd/src/types.rs, antd-mcp/src/antd_mcp/server.py, antd-mcp/README.md (ant-sdk)
• ant-cli/src/commands/data/file.rs, ant-cli/src/main.rs (ant-client)
• src/bin/ant-node/cli.rs, src/config.rs (ant-node)

Developer-facing change

• Streaming downloads landed: gRPC gains a Stream RPC and an implemented StreamPublic (previously UNIMPLEMENTED); REST gains an implemented GET /v1/data/public/{addr}/stream, raw by default and NDJSON with progress frames under Accept: application/x-ndjson.
• The REST external-signer prepare response now carries total_chunks and already_stored_count, surfacing the already-stored preflight so signers pay only for new chunks.
• Data Put/PutPublic responses gained chunks_stored and payment_mode_used.
• The MCP server gained a stream_download_file tool.
• The ant file download CLI command gained an optional --peers flag.
• The node's bootstrap-cache configuration was removed.

Files changed in this PR

• docs/sdk/reference/rest-api.md
• docs/sdk/reference/grpc-services.md
• docs/mcp/mcp-server-reference.md
• docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md
• docs/cli/command-reference.md
• docs/rust/embed-a-node-in-your-application.md

Why prose changed

• rest-api.md: rewrote the public-stream section from a stub to the implemented streaming behaviour, added total_chunks/already_stored_count to the REST prepare responses, and fixed on-network terminology -- tracks antd/openapi.yaml, antd/src/rest/{data,upload}.rs, and antd/src/types.rs.
• grpc-services.md: documented the Stream RPC, the implemented StreamPublic, the DataChunk oneof and DownloadProgress, and the new fields on the data Put responses -- tracks data.proto and grpc/service.rs.
• mcp-server-reference.md: added the stream_download_file tool and clarified the download_file shared-filesystem requirement -- tracks antd-mcp/src/antd_mcp/server.py and antd-mcp/README.md.
• use-external-signers-for-upload-payments.md: added the REST preflight fields to both prepare-response shapes and fixed on-network terminology -- tracks types.rs/openapi.yaml.
• command-reference.md: added the --peers flag (alias --peer-count) to ant file download -- tracks ant-cli/src/commands/data/file.rs.
• embed-a-node-in-your-application.md: removed the bootstrap_cache config field from the field list -- tracks the deletion in src/config.rs.

Verification run

• markdownlint / link checkers: skipped -- not configured in this repo / not installed in the run environment
• re-ran python3 scripts/sweep_poll.py on this branch -> status: "ok"; current output also reports newer ant-client/ant-node heads beyond this 2026-06-19 sweep, so those later drifts are left for a follow-up sweep
• changed code samples: JSON examples use placeholder tokens (<hex_id>, 0x...), consistent with the existing page convention, so a strict JSON parse was not applicable; example structure reviewed by hand and the cURL invocations checked for shape
• endpoint/type claims re-grepped against the pinned ant-sdk/ant-client/ant-node checkouts at the recorded sweep SHAs (e.g. public REST streaming, gRPC Stream/DownloadProgress, REST total_chunks/already_stored_count, --peers, the removed bootstrap_cache) -- all confirmed
• follow-up review found and fixed two overstatements: gRPC PrepareUploadResponse does not expose the REST preflight fields, and private REST POST /v1/data/stream is not in openapi.yaml
• git diff --check passes
• SKILL.md body re-audited and left unchanged; no skill patch release accompanies this run

Uncertainties

• The external-signer guide uses illustrative chunk counts in the examples; the exact numbers are placeholders.
• Private REST POST /v1/data/stream exists in the Rust router, but is absent from openapi.yaml; it is left out of rest-api.md until the canonical OpenAPI artifact records it.
• Manual-review issues: fixed in this update. Deferred ambiguous records: none.

---

Generated by Claude Code