tamarind-cli 0.3.0__tar.gz → 0.3.2__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.0 → tamarind_cli-0.3.2}/.github/workflows/ci.yml +7 -1
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/PKG-INFO +24 -5
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/README.md +23 -4
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/docs/architecture.md +29 -3
- tamarind_cli-0.3.2/openapi/pipelines-openapi-python-client.json +4 -0
- tamarind_cli-0.3.2/openapi/pipelines-v1.json +555 -0
- tamarind_cli-0.3.2/openapi/pipelines-v1.lock.json +8 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/public-v1.json +215 -147
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/public-v1.lock.json +2 -2
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/pyproject.toml +1 -1
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/scripts/check_custom_tools_provenance.py +13 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/scripts/sync_custom_tools_contract.py +14 -12
- tamarind_cli-0.3.2/scripts/sync_pipelines_contract.py +184 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/__init__.py +2 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/build_custom_tool_version.py +51 -16
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/cancel_custom_tool_build.py +58 -33
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool_upload.py +1 -15
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/delete_custom_tool.py +19 -22
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool_version.py +23 -29
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_build_logs.py +23 -29
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_versions.py +1 -15
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/publish_custom_tool_version.py +50 -29
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/update_custom_tool.py +19 -22
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool.py +2 -2
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version.py +8 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/client.py +3 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/resources.py +127 -42
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/transport.py +47 -27
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/http.py +4 -1
- tamarind_cli-0.3.2/src/tamarind/pipelines/__init__.py +17 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/__init__.py +8 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/__init__.py +1 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/__init__.py +1 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/get_run.py +177 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/list_node_run_molecules.py +268 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/client.py +272 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/errors.py +16 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/__init__.py +27 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/node_run_status.py +15 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run.py +168 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule.py +127 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule_page.py +89 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule_scores.py +47 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_problem.py +137 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_problem_errors_type_0_item.py +47 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_run.py +171 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_run_inputs.py +47 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/run_status.py +13 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/source.py +9 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/types.py +54 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/resources.py +204 -0
- tamarind_cli-0.3.2/src/tamarind/pipelines/transport.py +67 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_generation.py +34 -14
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_sdk.py +142 -44
- tamarind_cli-0.3.2/tests/test_pipelines_sdk.py +166 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/uv.lock +1 -1
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/.github/workflows/publish.yml +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/.gitignore +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/LICENSE +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/install.sh +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/openapi-python-client.json +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/catalog.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/auth.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/catalog.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/files.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/jobs.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/guidance.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/inputs.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/main.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/output.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/config.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_contract.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tools.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/client.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/errors.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/__init__.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_error.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_event.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_log_page.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result_action.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_gputype.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_memory.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_version_request.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_gputype.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_memory.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_page.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_status.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_problem.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_problem_errors_type_0_item.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_gpu_type_type_0.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_memory_type_0.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session_uploadheaders.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_page.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_status.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/types.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/packaging.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/validation.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/errors.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/jobs.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/py.typed +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/rest.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_agent_contract.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_bugbash.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_cli_commands.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_config.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_packaging.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_file_filters.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_inputs.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_jobs.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_output.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_pep561.py +0 -0
- {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_rest.py +0 -0
|
@@ -25,9 +25,13 @@ jobs:
|
|
|
25
25
|
--config openapi/openapi-python-client.json --meta none \
|
|
26
26
|
--output-path "$tmp_dir/generated" --overwrite
|
|
27
27
|
diff -ru --exclude=.ruff_cache src/tamarind/custom_tools/_generated "$tmp_dir/generated"
|
|
28
|
+
uv run --extra dev openapi-python-client generate --path openapi/pipelines-v1.json \
|
|
29
|
+
--config openapi/pipelines-openapi-python-client.json --meta none \
|
|
30
|
+
--output-path "$tmp_dir/pipelines-generated" --overwrite
|
|
31
|
+
diff -ru --exclude=.ruff_cache src/tamarind/pipelines/_generated "$tmp_dir/pipelines-generated"
|
|
28
32
|
|
|
29
33
|
typecheck:
|
|
30
|
-
name:
|
|
34
|
+
name: SDK type check
|
|
31
35
|
runs-on: ubuntu-latest
|
|
32
36
|
timeout-minutes: 5
|
|
33
37
|
steps:
|
|
@@ -40,9 +44,11 @@ jobs:
|
|
|
40
44
|
run: >-
|
|
41
45
|
uv run --extra dev mypy
|
|
42
46
|
src/tamarind/custom_tools
|
|
47
|
+
src/tamarind/pipelines
|
|
43
48
|
src/tamarind/http.py
|
|
44
49
|
src/tamarind/errors.py
|
|
45
50
|
scripts/sync_custom_tools_contract.py
|
|
51
|
+
scripts/sync_pipelines_contract.py
|
|
46
52
|
|
|
47
53
|
package:
|
|
48
54
|
name: Build release artifacts
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: tamarind-cli
|
|
3
|
-
Version: 0.3.
|
|
3
|
+
Version: 0.3.2
|
|
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
|
|
@@ -105,7 +105,20 @@ tamarind submit boltz \
|
|
|
105
105
|
|
|
106
106
|
## Python SDK
|
|
107
107
|
|
|
108
|
-
The package
|
|
108
|
+
The package exposes typed Pipelines and Custom Tools resources. Pipeline runs use
|
|
109
|
+
the same node-run terminology as the web app and public REST API:
|
|
110
|
+
|
|
111
|
+
```python
|
|
112
|
+
from tamarind import Tamarind
|
|
113
|
+
|
|
114
|
+
with Tamarind() as client:
|
|
115
|
+
run = client.pipelines.get_run("run-id")
|
|
116
|
+
for node_run in run.node_runs:
|
|
117
|
+
page = node_run.molecules(limit=100)
|
|
118
|
+
print(node_run.label, page.items)
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
The Custom Tools resource checks archive-local
|
|
109
122
|
safety, packages a folder, uploads it directly to object storage, and submits the
|
|
110
123
|
digest-checked build request. The server
|
|
111
124
|
remains authoritative for source readiness, Versions, logs, and the evolving
|
|
@@ -121,19 +134,25 @@ with Tamarind() as client:
|
|
|
121
134
|
except CustomToolNotFoundError:
|
|
122
135
|
tool = client.custom_tools.create("my-esmfold", display_name="My ESMFold")
|
|
123
136
|
|
|
124
|
-
result = tool.build("./my-esmfold")
|
|
137
|
+
result = tool.build("./my-esmfold", idempotency_key="release-2026-08-26")
|
|
125
138
|
print(result.action) # build, reuse_image, or unchanged
|
|
126
139
|
version = result.version
|
|
140
|
+
print(version.id, version.name) # opaque machine identity, human-facing label
|
|
127
141
|
if not version.terminal:
|
|
128
142
|
version = version.monitor(timeout=1800, on_event=print)
|
|
129
143
|
```
|
|
130
144
|
|
|
131
145
|
`build()` returns a typed result describing what the request did and the durable
|
|
132
146
|
Version it produced. It is convenience orchestration, not a durable request
|
|
133
|
-
object.
|
|
134
|
-
|
|
147
|
+
object. Reuse `idempotency_key` when retrying an ambiguous build response; the
|
|
148
|
+
server returns the already admitted Version. If no key was supplied, fetch the
|
|
149
|
+
tool's versions before retrying. Interrupting `monitor()` stops local monitoring; it
|
|
135
150
|
does not cancel the remote build.
|
|
136
151
|
|
|
152
|
+
Exact Version operations use `version.id`; `version.name` is display-only. If a
|
|
153
|
+
mutation reports `412 Precondition Failed`, refetch the affected Tool or Version,
|
|
154
|
+
confirm the mutation is still desired, and retry using the refreshed resource.
|
|
155
|
+
|
|
137
156
|
Custom Tool CLI commands are not part of this release. Existing CLI commands
|
|
138
157
|
remain unchanged.
|
|
139
158
|
|
|
@@ -80,7 +80,20 @@ tamarind submit boltz \
|
|
|
80
80
|
|
|
81
81
|
## Python SDK
|
|
82
82
|
|
|
83
|
-
The package
|
|
83
|
+
The package exposes typed Pipelines and Custom Tools resources. Pipeline runs use
|
|
84
|
+
the same node-run terminology as the web app and public REST API:
|
|
85
|
+
|
|
86
|
+
```python
|
|
87
|
+
from tamarind import Tamarind
|
|
88
|
+
|
|
89
|
+
with Tamarind() as client:
|
|
90
|
+
run = client.pipelines.get_run("run-id")
|
|
91
|
+
for node_run in run.node_runs:
|
|
92
|
+
page = node_run.molecules(limit=100)
|
|
93
|
+
print(node_run.label, page.items)
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The Custom Tools resource checks archive-local
|
|
84
97
|
safety, packages a folder, uploads it directly to object storage, and submits the
|
|
85
98
|
digest-checked build request. The server
|
|
86
99
|
remains authoritative for source readiness, Versions, logs, and the evolving
|
|
@@ -96,19 +109,25 @@ with Tamarind() as client:
|
|
|
96
109
|
except CustomToolNotFoundError:
|
|
97
110
|
tool = client.custom_tools.create("my-esmfold", display_name="My ESMFold")
|
|
98
111
|
|
|
99
|
-
result = tool.build("./my-esmfold")
|
|
112
|
+
result = tool.build("./my-esmfold", idempotency_key="release-2026-08-26")
|
|
100
113
|
print(result.action) # build, reuse_image, or unchanged
|
|
101
114
|
version = result.version
|
|
115
|
+
print(version.id, version.name) # opaque machine identity, human-facing label
|
|
102
116
|
if not version.terminal:
|
|
103
117
|
version = version.monitor(timeout=1800, on_event=print)
|
|
104
118
|
```
|
|
105
119
|
|
|
106
120
|
`build()` returns a typed result describing what the request did and the durable
|
|
107
121
|
Version it produced. It is convenience orchestration, not a durable request
|
|
108
|
-
object.
|
|
109
|
-
|
|
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
|
|
110
125
|
does not cancel the remote build.
|
|
111
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
|
+
|
|
112
131
|
Custom Tool CLI commands are not part of this release. Existing CLI commands
|
|
113
132
|
remain unchanged.
|
|
114
133
|
|
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
The CLI, the [MCP server](https://mcp.tamarind.bio), and the web app are all
|
|
4
4
|
**thin clients** over the same platform. The CLI never re-implements business
|
|
5
|
-
logic; it only knows how to call
|
|
5
|
+
logic; it only knows how to call four well-defined surfaces. This is what keeps
|
|
6
6
|
the CLI and the MCP from drifting as the platform evolves.
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## Four surfaces, four single sources of truth
|
|
9
9
|
|
|
10
10
|
### 1. Job/file REST surface — source of truth: the OpenAPI spec
|
|
11
11
|
|
|
@@ -72,7 +72,33 @@ 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.
|
|
89
|
+
|
|
90
|
+
### 4. Pipelines read surface — source of truth: the public OpenAPI artifact
|
|
91
|
+
|
|
92
|
+
`Tamarind().pipelines` reads a run and pages through the molecules produced by one
|
|
93
|
+
of its node runs. The sync script selects only those operations and their referenced
|
|
94
|
+
schemas from the website backend's frozen public OpenAPI artifact, verifies the exact
|
|
95
|
+
producer Git object, and records that commit in a dedicated lock. Keeping this
|
|
96
|
+
projection separate prevents Pipelines changes from broadening or perturbing the
|
|
97
|
+
Custom Tools contract.
|
|
98
|
+
|
|
99
|
+
Generated endpoint code owns URL encoding and wire-model parsing. A small resource
|
|
100
|
+
adapter adds strict runtime checks and composes `PipelineRun` → `NodeRun` → molecule
|
|
101
|
+
pages without introducing another public vocabulary.
|
|
76
102
|
|
|
77
103
|
## Why not a single binary that re-encodes the API?
|
|
78
104
|
|