tamarind-cli 0.3.1__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/PKG-INFO +27 -6
  2. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/README.md +25 -5
  3. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/docs/architecture.md +14 -1
  4. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/public-v1.json +181 -113
  5. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/public-v1.lock.json +2 -2
  6. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/pyproject.toml +2 -1
  7. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/sync_custom_tools_contract.py +11 -11
  8. tamarind_cli-0.4.0/src/tamarind/cli/commands/custom_tools.py +452 -0
  9. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/main.py +13 -1
  10. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/build_custom_tool_version.py +50 -23
  11. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/cancel_custom_tool_build.py +55 -41
  12. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool_upload.py +0 -25
  13. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/delete_custom_tool.py +19 -22
  14. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool_version.py +23 -40
  15. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_build_logs.py +23 -39
  16. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_versions.py +0 -24
  17. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/publish_custom_tool_version.py +47 -37
  18. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/update_custom_tool.py +19 -22
  19. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool.py +2 -2
  20. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version.py +8 -0
  21. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/resources.py +127 -42
  22. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/transport.py +37 -35
  23. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/http.py +4 -1
  24. tamarind_cli-0.4.0/tests/test_custom_tools_cli.py +316 -0
  25. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_generation.py +23 -11
  26. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_sdk.py +133 -39
  27. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/uv.lock +3 -1
  28. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.github/workflows/ci.yml +0 -0
  29. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.github/workflows/publish.yml +0 -0
  30. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.gitignore +0 -0
  31. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/LICENSE +0 -0
  32. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/install.sh +0 -0
  33. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/openapi-python-client.json +0 -0
  34. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-openapi-python-client.json +0 -0
  35. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-v1.json +0 -0
  36. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-v1.lock.json +0 -0
  37. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/check_custom_tools_provenance.py +0 -0
  38. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/sync_pipelines_contract.py +0 -0
  39. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/__init__.py +0 -0
  40. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/catalog.py +0 -0
  41. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/__init__.py +0 -0
  42. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/__init__.py +0 -0
  43. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/auth.py +0 -0
  44. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/catalog.py +0 -0
  45. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/files.py +0 -0
  46. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/jobs.py +0 -0
  47. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/guidance.py +0 -0
  48. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/inputs.py +0 -0
  49. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/output.py +0 -0
  50. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/config.py +0 -0
  51. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/__init__.py +0 -0
  52. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_contract.py +0 -0
  53. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/__init__.py +0 -0
  54. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/__init__.py +0 -0
  55. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/__init__.py +0 -0
  56. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool.py +0 -0
  57. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool.py +0 -0
  58. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tools.py +0 -0
  59. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/client.py +0 -0
  60. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/errors.py +0 -0
  61. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/__init__.py +0 -0
  62. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_error.py +0 -0
  63. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_event.py +0 -0
  64. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_log_page.py +0 -0
  65. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_result.py +0 -0
  66. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_result_action.py +0 -0
  67. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request.py +0 -0
  68. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_gputype.py +0 -0
  69. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_memory.py +0 -0
  70. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_version_request.py +0 -0
  71. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_gputype.py +0 -0
  72. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_memory.py +0 -0
  73. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_page.py +0 -0
  74. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_status.py +0 -0
  75. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_problem.py +0 -0
  76. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_problem_errors_type_0_item.py +0 -0
  77. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request.py +0 -0
  78. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_gpu_type_type_0.py +0 -0
  79. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_memory_type_0.py +0 -0
  80. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_upload_session.py +0 -0
  81. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_upload_session_uploadheaders.py +0 -0
  82. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version_page.py +0 -0
  83. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version_status.py +0 -0
  84. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/types.py +0 -0
  85. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/client.py +0 -0
  86. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/packaging.py +0 -0
  87. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/validation.py +0 -0
  88. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/errors.py +0 -0
  89. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/jobs.py +0 -0
  90. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/__init__.py +0 -0
  91. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/__init__.py +0 -0
  92. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/__init__.py +0 -0
  93. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/__init__.py +0 -0
  94. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/get_run.py +0 -0
  95. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/list_node_run_molecules.py +0 -0
  96. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/client.py +0 -0
  97. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/errors.py +0 -0
  98. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/__init__.py +0 -0
  99. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/node_run_status.py +0 -0
  100. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run.py +0 -0
  101. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule.py +0 -0
  102. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_page.py +0 -0
  103. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_scores.py +0 -0
  104. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_problem.py +0 -0
  105. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_problem_errors_type_0_item.py +0 -0
  106. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_run.py +0 -0
  107. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_run_inputs.py +0 -0
  108. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/run_status.py +0 -0
  109. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/source.py +0 -0
  110. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/types.py +0 -0
  111. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/resources.py +0 -0
  112. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/transport.py +0 -0
  113. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/py.typed +0 -0
  114. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/rest.py +0 -0
  115. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_agent_contract.py +0 -0
  116. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_bugbash.py +0 -0
  117. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_cli_commands.py +0 -0
  118. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_config.py +0 -0
  119. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_packaging.py +0 -0
  120. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_file_filters.py +0 -0
  121. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_inputs.py +0 -0
  122. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_jobs.py +0 -0
  123. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_output.py +0 -0
  124. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_pep561.py +0 -0
  125. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_pipelines_sdk.py +0 -0
  126. {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_rest.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: tamarind-cli
3
- Version: 0.3.1
3
+ Version: 0.4.0
4
4
  Summary: Command-line interface for the Tamarind Bio platform — submit, monitor, and download protein/molecule jobs from your terminal or an AI agent.
5
5
  Project-URL: Homepage, https://tamarind.bio
6
6
  Project-URL: Documentation, https://app.tamarind.bio/api-docs
@@ -11,6 +11,7 @@ License-File: LICENSE
11
11
  Keywords: agents,alphafold,bioinformatics,boltz,cli,protein
12
12
  Requires-Python: >=3.10
13
13
  Requires-Dist: attrs>=23.1
14
+ Requires-Dist: click>=8.1
14
15
  Requires-Dist: httpx>=0.27
15
16
  Requires-Dist: pyyaml>=6.0
16
17
  Requires-Dist: typer>=0.12
@@ -134,21 +135,40 @@ with Tamarind() as client:
134
135
  except CustomToolNotFoundError:
135
136
  tool = client.custom_tools.create("my-esmfold", display_name="My ESMFold")
136
137
 
137
- result = tool.build("./my-esmfold")
138
+ result = tool.build("./my-esmfold", idempotency_key="release-2026-08-26")
138
139
  print(result.action) # build, reuse_image, or unchanged
139
140
  version = result.version
141
+ print(version.id, version.name) # opaque machine identity, human-facing label
140
142
  if not version.terminal:
141
143
  version = version.monitor(timeout=1800, on_event=print)
142
144
  ```
143
145
 
144
146
  `build()` returns a typed result describing what the request did and the durable
145
147
  Version it produced. It is convenience orchestration, not a durable request
146
- object. If the connection is lost during the build response, fetch the tool's
147
- versions before retrying. Interrupting `monitor()` stops local monitoring; it
148
+ object. Reuse `idempotency_key` when retrying an ambiguous build response; the
149
+ server returns the already admitted Version. If no key was supplied, fetch the
150
+ tool's versions before retrying. Interrupting `monitor()` stops local monitoring; it
148
151
  does not cancel the remote build.
149
152
 
150
- Custom Tool CLI commands are not part of this release. Existing CLI commands
151
- remain unchanged.
153
+ Exact Version operations use `version.id`; `version.name` is display-only. If a
154
+ mutation reports `412 Precondition Failed`, refetch the affected Tool or Version,
155
+ confirm the mutation is still desired, and retry using the refreshed resource.
156
+
157
+ The same lifecycle is available through the unified CLI. A typical release is:
158
+
159
+ ```bash
160
+ tamarind custom-tools validate ./my-esmfold
161
+ tamarind custom-tools create my-esmfold --display-name "My ESMFold"
162
+ tamarind custom-tools build my-esmfold ./my-esmfold \
163
+ --idempotency-key release-2026-08-31 --wait --timeout 1800
164
+ tamarind custom-tools versions my-esmfold
165
+ tamarind custom-tools publish my-esmfold <opaque-version-id>
166
+ ```
167
+
168
+ Build responses contain both a display name such as `v3` and an opaque `id`.
169
+ Pass the opaque ID to `version`, `logs`, `cancel`, and `publish`. A local wait
170
+ timeout does not cancel the remote build; reattach with
171
+ `tamarind custom-tools version NAME VERSION_ID --wait`.
152
172
 
153
173
  ## Output for agents
154
174
 
@@ -194,6 +214,7 @@ place them before the command name.
194
214
  | Submit | `validate`, `submit`, `batch` |
195
215
  | Monitor | `jobs`, `status`, `wait`, `results`, `logs` |
196
216
  | Files | `files list`, `files stats`, `files upload`, `files delete`, `files folders` |
217
+ | Custom Tools | `custom-tools list`, `get`, `create`, `update`, `validate`, `build`, `versions`, `version`, `logs`, `cancel`, `publish`, `delete` |
197
218
  | Lifecycle | `cancel`, `delete` |
198
219
  | Auth | `auth login`, `auth status`, `auth logout` |
199
220
 
@@ -109,21 +109,40 @@ with Tamarind() as client:
109
109
  except CustomToolNotFoundError:
110
110
  tool = client.custom_tools.create("my-esmfold", display_name="My ESMFold")
111
111
 
112
- result = tool.build("./my-esmfold")
112
+ result = tool.build("./my-esmfold", idempotency_key="release-2026-08-26")
113
113
  print(result.action) # build, reuse_image, or unchanged
114
114
  version = result.version
115
+ print(version.id, version.name) # opaque machine identity, human-facing label
115
116
  if not version.terminal:
116
117
  version = version.monitor(timeout=1800, on_event=print)
117
118
  ```
118
119
 
119
120
  `build()` returns a typed result describing what the request did and the durable
120
121
  Version it produced. It is convenience orchestration, not a durable request
121
- object. If the connection is lost during the build response, fetch the tool's
122
- versions before retrying. Interrupting `monitor()` stops local monitoring; it
122
+ object. Reuse `idempotency_key` when retrying an ambiguous build response; the
123
+ server returns the already admitted Version. If no key was supplied, fetch the
124
+ tool's versions before retrying. Interrupting `monitor()` stops local monitoring; it
123
125
  does not cancel the remote build.
124
126
 
125
- Custom Tool CLI commands are not part of this release. Existing CLI commands
126
- remain unchanged.
127
+ Exact Version operations use `version.id`; `version.name` is display-only. If a
128
+ mutation reports `412 Precondition Failed`, refetch the affected Tool or Version,
129
+ confirm the mutation is still desired, and retry using the refreshed resource.
130
+
131
+ The same lifecycle is available through the unified CLI. A typical release is:
132
+
133
+ ```bash
134
+ tamarind custom-tools validate ./my-esmfold
135
+ tamarind custom-tools create my-esmfold --display-name "My ESMFold"
136
+ tamarind custom-tools build my-esmfold ./my-esmfold \
137
+ --idempotency-key release-2026-08-31 --wait --timeout 1800
138
+ tamarind custom-tools versions my-esmfold
139
+ tamarind custom-tools publish my-esmfold <opaque-version-id>
140
+ ```
141
+
142
+ Build responses contain both a display name such as `v3` and an opaque `id`.
143
+ Pass the opaque ID to `version`, `logs`, `cancel`, and `publish`. A local wait
144
+ timeout does not cancel the remote build; reattach with
145
+ `tamarind custom-tools version NAME VERSION_ID --wait`.
127
146
 
128
147
  ## Output for agents
129
148
 
@@ -169,6 +188,7 @@ place them before the command name.
169
188
  | Submit | `validate`, `submit`, `batch` |
170
189
  | Monitor | `jobs`, `status`, `wait`, `results`, `logs` |
171
190
  | Files | `files list`, `files stats`, `files upload`, `files delete`, `files folders` |
191
+ | Custom Tools | `custom-tools list`, `get`, `create`, `update`, `validate`, `build`, `versions`, `version`, `logs`, `cancel`, `publish`, `delete` |
172
192
  | Lifecycle | `cancel`, `delete` |
173
193
  | Auth | `auth login`, `auth status`, `auth logout` |
174
194
 
@@ -72,7 +72,20 @@ second list of configuration fields, enums, or cross-field rules.
72
72
  submit the digest-checked build request, and return a typed result containing the server's
73
73
  action plus its durable Version. It adds no server-side
74
74
  BuildRequest, queue, lease, claim, or repair state. An ambiguous build response
75
- is therefore handled honestly by listing Versions before a manual retry.
75
+ is retried with the same caller-selected `Idempotency-Key`, or handled by listing Versions when
76
+ the caller did not supply one.
77
+
78
+ The resource layer treats the returned opaque `Version.id` as the sole machine
79
+ selector for exact reads, logs, cancellation, and publication. The numbered
80
+ `Version.name` remains presentation metadata and is never reconstructed into an
81
+ endpoint path. Tool and Version ETags remain the mutation validators.
82
+
83
+ The generated contract and public SDK signatures use standard `If-Match`. At the
84
+ final HTTP adapter boundary, the CLI forwards that value as
85
+ `X-Tamarind-If-Match`: Vercel otherwise evaluates the original request field
86
+ against the post-mutation response ETag and can replace a committed success with
87
+ an edge-generated 412. This transport-only compatibility spelling does not change
88
+ the validator or stale-write semantics and is deliberately absent from OpenAPI.
76
89
 
77
90
  ### 4. Pipelines read surface — source of truth: the public OpenAPI artifact
78
91