Skip to content

Adopt antd 0.14.0 and the published antd clients - #105

Merged
JimCollinson merged 1 commit into
mainfrom
claude/docs-cli-updates-ikthvj
Sep 25, 2026
Merged

JimCollinson merged 1 commit into
mainfrom
claude/docs-cli-updates-ikthvj

Conversation

@JimCollinson

@JimCollinson JimCollinson commented Sep 25, 2026 •

Copy link
Copy Markdown
Member

Summary

Moves the daemon documentation to antd 0.14.0 (ant-sdk v0.14.0, commit dbf6a7d) and the client pages to the 0.2.0 packages published on 2026-09-25.

  • Simpler client installs. Python, JavaScript, TypeScript, C#, Ruby, PHP, Dart, and Go install from PyPI, npm, NuGet, RubyGems, Packagist, pub.dev, and the Go module proxy with bare commands (no version pins), replacing source checkouts. Each page states once which versions its examples use. Dart moves to the renamed antd_client package; PHP's minimum is corrected to 8.2.
  • Missing-data defect removed. antd 0.14.0 maps an unknown address to 404 / NOT_FOUND instead of 500 / INTERNAL_ERROR. The caveats are removed across about 20 pages, and every error-handling example now catches the client's not-found error.
  • Partial-upload recovery. Documents resumable external-signer finalize: the PARTIAL_UPLOAD 502 body (chunks_stored, chunks_failed, total_chunks, retryable), when to repeat the same finalize versus re-prepare, and the gRPC ABORTED form. The External Signers guide gains a "Recover from a partial store" step; each published client page names its typed partial-upload error.
  • Reference updates. Required code field in REST errors; gRPC PrepareUploadResponse total_chunks and already_stored_count; verify-quotes limits; public upload counts and costs that include the DataMap chunk.
  • Daemon install. New release URLs, SHA-256 digests from the GitHub release, and version output antd 0.14.0 (build dbf6a7d3d951).
  • Architecture and Source Repositories. antd 0.14.0 now uses ant-core 0.10.0 and shares its dependency versions with ant-cli 0.3.8 and ant-node 0.20.0; the release also publishes a container image.
  • MCP. The server installs from the v0.14.0 tag; the error table gains PARTIAL_UPLOAD.

Source-only clients (C++, Java, Kotlin, Swift, Zig, Rust) keep their v0.12.1 source pins; only their daemon references and not-found handling change. Native SDKs are unchanged at 0.0.9.

Validation

  • antd 0.14.0 at runtime, built from the v0.14.0 tag and run locally with --ipv4-only (no network peers reachable from the check host):
    • --version prints antd 0.14.0 (build dbf6a7d3d951)
    • /health reports version 0.14.0 and build_commit dbf6a7d3d951
    • an unknown address returns 404 {"code":"NOT_FOUND"}, and a malformed one 400 {"code":"BAD_REQUEST"}
  • Client not-found examples against that daemon. Python, JavaScript, TypeScript, Go, Ruby and PHP, using the published 0.2.0 packages and Go module v0.14.0, each catch their client's not-found error and print the documented output.
  • Other client examples. These run with the documented output against a stand-in server returning antd 0.14-shaped responses, including a PARTIAL_UPLOAD body; each client's typed partial-upload error and its fields were checked there. The C# and Dart packages were downloaded and their examples checked against the published source; no .NET or Dart toolchain was available to compile them.
  • Onboarding examples. The Store Data and Retrieve Data Python and Node.js examples reach the real daemon and handle the not-found response.
  • MCP. The documented uv tool install from v0.14.0 installs antd-mcp 0.1.0, and its client maps PARTIAL_UPLOAD.
  • Repository checks. All 53 repository tests and ADR governance pass. git diff --check is clean, all 297 relative links and anchors in the 35 changed pages resolve, and all 108 verification blocks are unchanged.
  • Source facts. Checked against the v0.14.0 tag (antd/openapi.yaml, antd/proto, antd/src) and the v0.13.0..v0.14.0 diff. The 0.2.0 clients come from 8481c6f, which only bumps versions over v0.14.0.

Not verified

  • No public-network read or paid upload ran; the check host blocks outbound UDP.
  • The Linux glibc 2.38 requirement is carried forward from the 0.13.0 binaries. The 0.14.0 binaries come from the same release runners but were not inspected.
  • C# and Dart examples were not compiled.

Found but not changed

These predate this release and are outside this PR:

  • Unhandled connection errors. With no daemon running, the Ruby, PHP and Python connect examples fail with the raw connection error, which their AntdError handlers don't catch.
  • Go connect output. The Go connect example prints http://localhost:8082 when no port file exists, but its expected output only shows http://127.0.0.1:<port>.

Follow-ups

Merging publishes to docs.autonomi.com/developers through GitBook Git Sync.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor

Move the daemon pages to antd 0.14.0 (ant-sdk v0.14.0, dbf6a7d) and
the client pages to the 0.2.0 packages published on 2026-09-25.

- Install: new release URLs, SHA-256 digests from the GitHub release,
  and version output `antd 0.14.0 (build dbf6a7d3d951)`.
- Clients: Python, JavaScript, TypeScript, C#, Ruby, PHP, Dart, and Go
  install from PyPI, npm, NuGet, RubyGems, Packagist, pub.dev, and the
  Go module proxy with bare commands, plus one line per page naming the
  versions the examples use. Dart moves to the renamed antd_client
  package; PHP's minimum is 8.2.
- Errors: antd 0.14.0 maps an unknown address to 404 NOT_FOUND, so the
  missing-DataMap-as-500 caveats are removed and examples catch each
  client's not-found error. REST error bodies carry a required `code`.
- Partial uploads: document resumable external-signer finalize, the
  PARTIAL_UPLOAD error fields, and each client's typed partial-upload
  error; add a recovery step to the external-signer guide.
- Reference: gRPC prepare counts, verify-quotes limits, public upload
  counts that include the DataMap chunk, MCP server from v0.14.0 with the
  PARTIAL_UPLOAD code.
- Architecture and Source Repositories: antd now shares ant-core 0.10.0
  and its dependency versions with the CLI and node.

Source-only clients (C++, Java, Kotlin, Swift, Zig, Rust) keep their
v0.12.1 source pins. Verification stamps are unchanged (#104).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
@JimCollinson
JimCollinson marked this pull request as ready for review September 25, 2026 20:34
@JimCollinson
JimCollinson merged commit 2956957 into main Sep 25, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants