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.
Files changed (124) hide show
  1. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/.github/workflows/ci.yml +7 -1
  2. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/PKG-INFO +24 -5
  3. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/README.md +23 -4
  4. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/docs/architecture.md +29 -3
  5. tamarind_cli-0.3.2/openapi/pipelines-openapi-python-client.json +4 -0
  6. tamarind_cli-0.3.2/openapi/pipelines-v1.json +555 -0
  7. tamarind_cli-0.3.2/openapi/pipelines-v1.lock.json +8 -0
  8. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/public-v1.json +215 -147
  9. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/public-v1.lock.json +2 -2
  10. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/pyproject.toml +1 -1
  11. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/scripts/check_custom_tools_provenance.py +13 -0
  12. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/scripts/sync_custom_tools_contract.py +14 -12
  13. tamarind_cli-0.3.2/scripts/sync_pipelines_contract.py +184 -0
  14. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/__init__.py +2 -0
  15. {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
  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
  17. {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
  18. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/delete_custom_tool.py +19 -22
  19. {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
  20. {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
  21. {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
  22. {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
  23. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/update_custom_tool.py +19 -22
  24. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool.py +2 -2
  25. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version.py +8 -0
  26. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/client.py +3 -0
  27. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/resources.py +127 -42
  28. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/transport.py +47 -27
  29. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/http.py +4 -1
  30. tamarind_cli-0.3.2/src/tamarind/pipelines/__init__.py +17 -0
  31. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/__init__.py +8 -0
  32. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/__init__.py +1 -0
  33. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/__init__.py +1 -0
  34. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/get_run.py +177 -0
  35. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/api/pipelines_public/list_node_run_molecules.py +268 -0
  36. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/client.py +272 -0
  37. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/errors.py +16 -0
  38. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/__init__.py +27 -0
  39. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/node_run_status.py +15 -0
  40. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run.py +168 -0
  41. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule.py +127 -0
  42. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule_page.py +89 -0
  43. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_node_run_molecule_scores.py +47 -0
  44. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_problem.py +137 -0
  45. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_problem_errors_type_0_item.py +47 -0
  46. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_run.py +171 -0
  47. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/public_run_inputs.py +47 -0
  48. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/run_status.py +13 -0
  49. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/models/source.py +9 -0
  50. tamarind_cli-0.3.2/src/tamarind/pipelines/_generated/types.py +54 -0
  51. tamarind_cli-0.3.2/src/tamarind/pipelines/resources.py +204 -0
  52. tamarind_cli-0.3.2/src/tamarind/pipelines/transport.py +67 -0
  53. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_generation.py +34 -14
  54. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_sdk.py +142 -44
  55. tamarind_cli-0.3.2/tests/test_pipelines_sdk.py +166 -0
  56. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/uv.lock +1 -1
  57. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/.github/workflows/publish.yml +0 -0
  58. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/.gitignore +0 -0
  59. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/LICENSE +0 -0
  60. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/install.sh +0 -0
  61. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/openapi/openapi-python-client.json +0 -0
  62. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/catalog.py +0 -0
  63. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/__init__.py +0 -0
  64. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/__init__.py +0 -0
  65. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/auth.py +0 -0
  66. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/catalog.py +0 -0
  67. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/files.py +0 -0
  68. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/jobs.py +0 -0
  69. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/guidance.py +0 -0
  70. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/inputs.py +0 -0
  71. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/main.py +0 -0
  72. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/cli/output.py +0 -0
  73. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/config.py +0 -0
  74. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/__init__.py +0 -0
  75. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_contract.py +0 -0
  76. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/__init__.py +0 -0
  77. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/__init__.py +0 -0
  78. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/__init__.py +0 -0
  79. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool.py +0 -0
  80. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool.py +0 -0
  81. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tools.py +0 -0
  82. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/client.py +0 -0
  83. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/errors.py +0 -0
  84. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/__init__.py +0 -0
  85. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_error.py +0 -0
  86. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_event.py +0 -0
  87. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_log_page.py +0 -0
  88. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result.py +0 -0
  89. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result_action.py +0 -0
  90. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request.py +0 -0
  91. {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
  92. {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
  93. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_version_request.py +0 -0
  94. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_gputype.py +0 -0
  95. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_memory.py +0 -0
  96. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_page.py +0 -0
  97. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_status.py +0 -0
  98. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_problem.py +0 -0
  99. {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
  100. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request.py +0 -0
  101. {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
  102. {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
  103. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session.py +0 -0
  104. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session_uploadheaders.py +0 -0
  105. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_page.py +0 -0
  106. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_status.py +0 -0
  107. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/types.py +0 -0
  108. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/packaging.py +0 -0
  109. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/validation.py +0 -0
  110. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/errors.py +0 -0
  111. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/jobs.py +0 -0
  112. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/py.typed +0 -0
  113. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/src/tamarind/rest.py +0 -0
  114. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_agent_contract.py +0 -0
  115. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_bugbash.py +0 -0
  116. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_cli_commands.py +0 -0
  117. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_config.py +0 -0
  118. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_custom_tools_packaging.py +0 -0
  119. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_file_filters.py +0 -0
  120. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_inputs.py +0 -0
  121. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_jobs.py +0 -0
  122. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_output.py +0 -0
  123. {tamarind_cli-0.3.0 → tamarind_cli-0.3.2}/tests/test_pep561.py +0 -0
  124. {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: Custom Tools type check
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.0
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 also exposes a typed Custom Tools SDK. It checks archive-local
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. If the connection is lost during the build response, fetch the tool's
134
- versions before retrying. Interrupting `monitor()` stops local monitoring; it
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 also exposes a typed Custom Tools SDK. It checks archive-local
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. If the connection is lost during the build response, fetch the tool's
109
- 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
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 three well-defined surfaces. This is what keeps
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
- ## Three surfaces, three single sources of truth
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 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.
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
 
@@ -0,0 +1,4 @@
1
+ {
2
+ "package_name_override": "_generated",
3
+ "project_name_override": "tamarind-pipelines-generated"
4
+ }