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.
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/PKG-INFO +27 -6
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/README.md +25 -5
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/docs/architecture.md +14 -1
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/public-v1.json +181 -113
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/public-v1.lock.json +2 -2
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/pyproject.toml +2 -1
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/sync_custom_tools_contract.py +11 -11
- tamarind_cli-0.4.0/src/tamarind/cli/commands/custom_tools.py +452 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/main.py +13 -1
- {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
- {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
- {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
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/delete_custom_tool.py +19 -22
- {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
- {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
- {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
- {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
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/update_custom_tool.py +19 -22
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool.py +2 -2
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version.py +8 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/resources.py +127 -42
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/transport.py +37 -35
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/http.py +4 -1
- tamarind_cli-0.4.0/tests/test_custom_tools_cli.py +316 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_generation.py +23 -11
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_sdk.py +133 -39
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/uv.lock +3 -1
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.github/workflows/ci.yml +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.github/workflows/publish.yml +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/.gitignore +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/LICENSE +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/install.sh +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/openapi-python-client.json +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-openapi-python-client.json +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-v1.json +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/openapi/pipelines-v1.lock.json +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/check_custom_tools_provenance.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/scripts/sync_pipelines_contract.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/catalog.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/auth.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/catalog.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/files.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/commands/jobs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/guidance.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/inputs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/cli/output.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/config.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_contract.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tools.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/client.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/errors.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_error.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_event.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_log_page.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_result.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_build_result_action.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request.py +0 -0
- {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
- {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
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_create_version_request.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_gputype.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_memory.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_page.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_custom_tool_status.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_problem.py +0 -0
- {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
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request.py +0 -0
- {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
- {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
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_upload_session.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_upload_session_uploadheaders.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version_page.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/models/public_version_status.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/_generated/types.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/client.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/packaging.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/custom_tools/validation.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/errors.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/jobs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/get_run.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/api/pipelines_public/list_node_run_molecules.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/client.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/errors.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/__init__.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/node_run_status.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_page.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_scores.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_problem.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_problem_errors_type_0_item.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_run.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/public_run_inputs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/run_status.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/models/source.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/_generated/types.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/resources.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/pipelines/transport.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/py.typed +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/src/tamarind/rest.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_agent_contract.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_bugbash.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_cli_commands.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_config.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_custom_tools_packaging.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_file_filters.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_inputs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_jobs.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_output.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_pep561.py +0 -0
- {tamarind_cli-0.3.1 → tamarind_cli-0.4.0}/tests/test_pipelines_sdk.py +0 -0
- {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
|
+
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.
|
|
147
|
-
|
|
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
|
-
|
|
151
|
-
|
|
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.
|
|
122
|
-
|
|
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
|
-
|
|
126
|
-
|
|
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
|
|
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
|
|