tamarind-cli 0.3.1__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.1 → tamarind_cli-0.3.2}/PKG-INFO +10 -4
  2. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/README.md +9 -3
  3. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/docs/architecture.md +14 -1
  4. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/public-v1.json +181 -113
  5. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/public-v1.lock.json +2 -2
  6. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/pyproject.toml +1 -1
  7. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/scripts/sync_custom_tools_contract.py +11 -11
  8. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/build_custom_tool_version.py +50 -23
  9. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/cancel_custom_tool_build.py +55 -41
  10. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool_upload.py +0 -25
  11. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/delete_custom_tool.py +19 -22
  12. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool_version.py +23 -40
  13. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_build_logs.py +23 -39
  14. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tool_versions.py +0 -24
  15. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/publish_custom_tool_version.py +47 -37
  16. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/update_custom_tool.py +19 -22
  17. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool.py +2 -2
  18. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version.py +8 -0
  19. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/resources.py +127 -42
  20. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/transport.py +37 -35
  21. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/http.py +4 -1
  22. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_custom_tools_generation.py +23 -11
  23. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_custom_tools_sdk.py +133 -39
  24. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/uv.lock +1 -1
  25. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/.github/workflows/ci.yml +0 -0
  26. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/.github/workflows/publish.yml +0 -0
  27. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/.gitignore +0 -0
  28. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/LICENSE +0 -0
  29. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/install.sh +0 -0
  30. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/openapi-python-client.json +0 -0
  31. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/pipelines-openapi-python-client.json +0 -0
  32. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/pipelines-v1.json +0 -0
  33. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/openapi/pipelines-v1.lock.json +0 -0
  34. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/scripts/check_custom_tools_provenance.py +0 -0
  35. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/scripts/sync_pipelines_contract.py +0 -0
  36. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/__init__.py +0 -0
  37. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/catalog.py +0 -0
  38. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/__init__.py +0 -0
  39. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/__init__.py +0 -0
  40. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/auth.py +0 -0
  41. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/catalog.py +0 -0
  42. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/files.py +0 -0
  43. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/commands/jobs.py +0 -0
  44. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/guidance.py +0 -0
  45. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/inputs.py +0 -0
  46. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/main.py +0 -0
  47. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/cli/output.py +0 -0
  48. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/config.py +0 -0
  49. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/__init__.py +0 -0
  50. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_contract.py +0 -0
  51. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/__init__.py +0 -0
  52. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/__init__.py +0 -0
  53. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/__init__.py +0 -0
  54. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/create_custom_tool.py +0 -0
  55. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/get_custom_tool.py +0 -0
  56. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/api/custom_tools/list_custom_tools.py +0 -0
  57. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/client.py +0 -0
  58. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/errors.py +0 -0
  59. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/__init__.py +0 -0
  60. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_error.py +0 -0
  61. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_event.py +0 -0
  62. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_log_page.py +0 -0
  63. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result.py +0 -0
  64. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_build_result_action.py +0 -0
  65. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request.py +0 -0
  66. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_gputype.py +0 -0
  67. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_custom_tool_request_memory.py +0 -0
  68. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_create_version_request.py +0 -0
  69. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_gputype.py +0 -0
  70. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_memory.py +0 -0
  71. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_page.py +0 -0
  72. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_custom_tool_status.py +0 -0
  73. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_problem.py +0 -0
  74. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_problem_errors_type_0_item.py +0 -0
  75. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request.py +0 -0
  76. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_gpu_type_type_0.py +0 -0
  77. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_update_custom_tool_request_memory_type_0.py +0 -0
  78. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session.py +0 -0
  79. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_upload_session_uploadheaders.py +0 -0
  80. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_page.py +0 -0
  81. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/models/public_version_status.py +0 -0
  82. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/_generated/types.py +0 -0
  83. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/client.py +0 -0
  84. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/packaging.py +0 -0
  85. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/custom_tools/validation.py +0 -0
  86. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/errors.py +0 -0
  87. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/jobs.py +0 -0
  88. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/__init__.py +0 -0
  89. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/__init__.py +0 -0
  90. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/api/__init__.py +0 -0
  91. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/api/pipelines_public/__init__.py +0 -0
  92. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/api/pipelines_public/get_run.py +0 -0
  93. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/api/pipelines_public/list_node_run_molecules.py +0 -0
  94. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/client.py +0 -0
  95. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/errors.py +0 -0
  96. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/__init__.py +0 -0
  97. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/node_run_status.py +0 -0
  98. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_node_run.py +0 -0
  99. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_node_run_molecule.py +0 -0
  100. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_page.py +0 -0
  101. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_node_run_molecule_scores.py +0 -0
  102. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_problem.py +0 -0
  103. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_problem_errors_type_0_item.py +0 -0
  104. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_run.py +0 -0
  105. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/public_run_inputs.py +0 -0
  106. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/run_status.py +0 -0
  107. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/models/source.py +0 -0
  108. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/_generated/types.py +0 -0
  109. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/resources.py +0 -0
  110. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/pipelines/transport.py +0 -0
  111. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/py.typed +0 -0
  112. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/src/tamarind/rest.py +0 -0
  113. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_agent_contract.py +0 -0
  114. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_bugbash.py +0 -0
  115. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_cli_commands.py +0 -0
  116. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_config.py +0 -0
  117. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_custom_tools_packaging.py +0 -0
  118. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_file_filters.py +0 -0
  119. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_inputs.py +0 -0
  120. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_jobs.py +0 -0
  121. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_output.py +0 -0
  122. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_pep561.py +0 -0
  123. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/tests/test_pipelines_sdk.py +0 -0
  124. {tamarind_cli-0.3.1 → tamarind_cli-0.3.2}/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.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
@@ -134,19 +134,25 @@ with Tamarind() as client:
134
134
  except CustomToolNotFoundError:
135
135
  tool = client.custom_tools.create("my-esmfold", display_name="My ESMFold")
136
136
 
137
- result = tool.build("./my-esmfold")
137
+ result = tool.build("./my-esmfold", idempotency_key="release-2026-08-26")
138
138
  print(result.action) # build, reuse_image, or unchanged
139
139
  version = result.version
140
+ print(version.id, version.name) # opaque machine identity, human-facing label
140
141
  if not version.terminal:
141
142
  version = version.monitor(timeout=1800, on_event=print)
142
143
  ```
143
144
 
144
145
  `build()` returns a typed result describing what the request did and the durable
145
146
  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
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
148
150
  does not cancel the remote build.
149
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
+
150
156
  Custom Tool CLI commands are not part of this release. Existing CLI commands
151
157
  remain unchanged.
152
158
 
@@ -109,19 +109,25 @@ 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
 
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
+
125
131
  Custom Tool CLI commands are not part of this release. Existing CLI commands
126
132
  remain unchanged.
127
133
 
@@ -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
 
@@ -1,6 +1,16 @@
1
1
  {
2
2
  "components": {
3
3
  "responses": {
4
+ "Conflict": {
5
+ "content": {
6
+ "application/problem+json": {
7
+ "schema": {
8
+ "$ref": "#/components/schemas/PublicProblem"
9
+ }
10
+ }
11
+ },
12
+ "description": "The request conflicts with current resource state."
13
+ },
4
14
  "Error": {
5
15
  "content": {
6
16
  "application/problem+json": {
@@ -29,7 +39,17 @@
29
39
  }
30
40
  }
31
41
  },
32
- "description": "The supplied current-resource validator is stale."
42
+ "description": "The supplied current-resource validator is stale. Refetch the affected resource, confirm the mutation is still desired, and retry with its new ETag."
43
+ },
44
+ "PreconditionRequired": {
45
+ "content": {
46
+ "application/problem+json": {
47
+ "schema": {
48
+ "$ref": "#/components/schemas/PublicProblem"
49
+ }
50
+ }
51
+ },
52
+ "description": "A required current-resource validator was omitted."
33
53
  },
34
54
  "Unauthorized": {
35
55
  "content": {
@@ -306,7 +326,7 @@
306
326
  "type": "array"
307
327
  },
308
328
  "generation": {
309
- "description": "The immutable generation identity. Current Tool mutations use its quoted `ETag`; generation-owned upload and Version requests send it in `X-Tamarind-Tool-Generation`.",
329
+ "description": "The immutable lifetime identity of this Tool name. Clients use the Tool's quoted `ETag` with standard `If-Match`; exact Version operations use each Version's opaque `id`.",
310
330
  "title": "Generation",
311
331
  "type": "string"
312
332
  },
@@ -770,6 +790,11 @@
770
790
  }
771
791
  ]
772
792
  },
793
+ "id": {
794
+ "description": "Opaque immutable identifier used in exact Version endpoint paths.",
795
+ "title": "Id",
796
+ "type": "string"
797
+ },
773
798
  "name": {
774
799
  "description": "The numbered version handle, such as `v3`.",
775
800
  "title": "Name",
@@ -817,6 +842,7 @@
817
842
  }
818
843
  },
819
844
  "required": [
845
+ "id",
820
846
  "name",
821
847
  "sourceRevision",
822
848
  "sourceDigest",
@@ -1013,7 +1039,16 @@
1013
1039
  }
1014
1040
  }
1015
1041
  },
1016
- "description": "Successful Response"
1042
+ "description": "The created Tool.",
1043
+ "headers": {
1044
+ "ETag": {
1045
+ "description": "Quoted strong validator for requests that target this Tool.",
1046
+ "schema": {
1047
+ "example": "\"01JABCDEF0123456789XYZ\"",
1048
+ "type": "string"
1049
+ }
1050
+ }
1051
+ }
1017
1052
  },
1018
1053
  "401": {
1019
1054
  "$ref": "#/components/responses/Unauthorized"
@@ -1052,14 +1087,12 @@
1052
1087
  }
1053
1088
  },
1054
1089
  {
1055
- "description": "The strong ETag returned by `GET /custom-tools/{name}`, including its double quotes. This product-specific header preserves `If-Match` semantics across the public CDN edge.",
1090
+ "description": "One or more entity-tags using standard If-Match syntax, or `*` to match any existing Tool. Only strong validators can match. The ETag returned with the Tool prevents stale requests from acting on a changed, deleted, or recreated Tool with the same name.",
1056
1091
  "in": "header",
1057
- "name": "X-Tamarind-If-Match",
1092
+ "name": "If-Match",
1058
1093
  "required": true,
1059
1094
  "schema": {
1060
- "description": "The strong ETag returned by `GET /custom-tools/{name}`, including its double quotes. This product-specific header preserves `If-Match` semantics across the public CDN edge.",
1061
1095
  "minLength": 1,
1062
- "title": "X-Tamarind-If-Match",
1063
1096
  "type": "string"
1064
1097
  }
1065
1098
  }
@@ -1080,6 +1113,9 @@
1080
1113
  "422": {
1081
1114
  "$ref": "#/components/responses/ValidationProblem"
1082
1115
  },
1116
+ "428": {
1117
+ "$ref": "#/components/responses/PreconditionRequired"
1118
+ },
1083
1119
  "default": {
1084
1120
  "$ref": "#/components/responses/Error"
1085
1121
  }
@@ -1121,7 +1157,7 @@
1121
1157
  "description": "The current Tool generation.",
1122
1158
  "headers": {
1123
1159
  "ETag": {
1124
- "description": "Quoted strong validator for PATCH and DELETE.",
1160
+ "description": "Quoted strong validator for requests that target this Tool.",
1125
1161
  "schema": {
1126
1162
  "example": "\"01JABCDEF0123456789XYZ\"",
1127
1163
  "type": "string"
@@ -1167,14 +1203,12 @@
1167
1203
  }
1168
1204
  },
1169
1205
  {
1170
- "description": "The strong ETag returned by `GET /custom-tools/{name}`, including its double quotes. This product-specific header preserves `If-Match` semantics across the public CDN edge.",
1206
+ "description": "One or more entity-tags using standard If-Match syntax, or `*` to match any existing Tool. Only strong validators can match. The ETag returned with the Tool prevents stale requests from acting on a changed, deleted, or recreated Tool with the same name.",
1171
1207
  "in": "header",
1172
- "name": "X-Tamarind-If-Match",
1208
+ "name": "If-Match",
1173
1209
  "required": true,
1174
1210
  "schema": {
1175
- "description": "The strong ETag returned by `GET /custom-tools/{name}`, including its double quotes. This product-specific header preserves `If-Match` semantics across the public CDN edge.",
1176
1211
  "minLength": 1,
1177
- "title": "X-Tamarind-If-Match",
1178
1212
  "type": "string"
1179
1213
  }
1180
1214
  }
@@ -1198,7 +1232,16 @@
1198
1232
  }
1199
1233
  }
1200
1234
  },
1201
- "description": "Successful Response"
1235
+ "description": "The updated Tool.",
1236
+ "headers": {
1237
+ "ETag": {
1238
+ "description": "Quoted strong validator for requests that target this Tool.",
1239
+ "schema": {
1240
+ "example": "\"01JABCDEF0123456789XYZ\"",
1241
+ "type": "string"
1242
+ }
1243
+ }
1244
+ }
1202
1245
  },
1203
1246
  "401": {
1204
1247
  "$ref": "#/components/responses/Unauthorized"
@@ -1212,6 +1255,9 @@
1212
1255
  "422": {
1213
1256
  "$ref": "#/components/responses/ValidationProblem"
1214
1257
  },
1258
+ "428": {
1259
+ "$ref": "#/components/responses/PreconditionRequired"
1260
+ },
1215
1261
  "default": {
1216
1262
  "$ref": "#/components/responses/Error"
1217
1263
  }
@@ -1241,19 +1287,6 @@
1241
1287
  "title": "Name",
1242
1288
  "type": "string"
1243
1289
  }
1244
- },
1245
- {
1246
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1247
- "in": "header",
1248
- "name": "X-Tamarind-Tool-Generation",
1249
- "required": true,
1250
- "schema": {
1251
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1252
- "maxLength": 128,
1253
- "minLength": 1,
1254
- "title": "X-Tamarind-Tool-Generation",
1255
- "type": "string"
1256
- }
1257
1290
  }
1258
1291
  ],
1259
1292
  "responses": {
@@ -1356,19 +1389,6 @@
1356
1389
  "description": "Pagination token from the previous response's `nextCursor`.",
1357
1390
  "title": "Cursor"
1358
1391
  }
1359
- },
1360
- {
1361
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1362
- "in": "header",
1363
- "name": "X-Tamarind-Tool-Generation",
1364
- "required": true,
1365
- "schema": {
1366
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1367
- "maxLength": 128,
1368
- "minLength": 1,
1369
- "title": "X-Tamarind-Tool-Generation",
1370
- "type": "string"
1371
- }
1372
1392
  }
1373
1393
  ],
1374
1394
  "responses": {
@@ -1420,15 +1440,31 @@
1420
1440
  }
1421
1441
  },
1422
1442
  {
1423
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1443
+ "description": "Retries the same build request without admitting duplicate work. Reusing a key with different source or runtime facts returns 409 Conflict.",
1444
+ "in": "header",
1445
+ "name": "Idempotency-Key",
1446
+ "required": false,
1447
+ "schema": {
1448
+ "anyOf": [
1449
+ {
1450
+ "maxLength": 255,
1451
+ "type": "string"
1452
+ },
1453
+ {
1454
+ "type": "null"
1455
+ }
1456
+ ],
1457
+ "description": "Retries the same build request without admitting duplicate work. Reusing a key with different source or runtime facts returns 409 Conflict.",
1458
+ "title": "Idempotency-Key"
1459
+ }
1460
+ },
1461
+ {
1462
+ "description": "One or more entity-tags using standard If-Match syntax, or `*` to match any existing Tool. Only strong validators can match. The ETag returned with the Tool prevents stale requests from acting on a changed, deleted, or recreated Tool with the same name.",
1424
1463
  "in": "header",
1425
- "name": "X-Tamarind-Tool-Generation",
1464
+ "name": "If-Match",
1426
1465
  "required": true,
1427
1466
  "schema": {
1428
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1429
- "maxLength": 128,
1430
1467
  "minLength": 1,
1431
- "title": "X-Tamarind-Tool-Generation",
1432
1468
  "type": "string"
1433
1469
  }
1434
1470
  }
@@ -1452,7 +1488,23 @@
1452
1488
  }
1453
1489
  }
1454
1490
  },
1455
- "description": "Successful Response"
1491
+ "description": "The admitted Version.",
1492
+ "headers": {
1493
+ "ETag": {
1494
+ "description": "Quoted strong validator for requests that target this Version.",
1495
+ "schema": {
1496
+ "example": "\"eyJvcGFxdWUiOiJ2ZXJzaW9uIn0\"",
1497
+ "type": "string"
1498
+ }
1499
+ },
1500
+ "Location": {
1501
+ "description": "Relative URL of the exact Version admitted or reused by this request.",
1502
+ "schema": {
1503
+ "example": "./versions/ver_eyJvcGFxdWUiOiJ2ZXJzaW9uIn0",
1504
+ "type": "string"
1505
+ }
1506
+ }
1507
+ }
1456
1508
  },
1457
1509
  "401": {
1458
1510
  "$ref": "#/components/responses/Unauthorized"
@@ -1460,9 +1512,18 @@
1460
1512
  "404": {
1461
1513
  "$ref": "#/components/responses/NotFound"
1462
1514
  },
1515
+ "409": {
1516
+ "$ref": "#/components/responses/Conflict"
1517
+ },
1518
+ "412": {
1519
+ "$ref": "#/components/responses/PreconditionFailed"
1520
+ },
1463
1521
  "422": {
1464
1522
  "$ref": "#/components/responses/ValidationProblem"
1465
1523
  },
1524
+ "428": {
1525
+ "$ref": "#/components/responses/PreconditionRequired"
1526
+ },
1466
1527
  "default": {
1467
1528
  "$ref": "#/components/responses/Error"
1468
1529
  }
@@ -1474,7 +1535,7 @@
1474
1535
  "x-doc-group": "Custom Tools"
1475
1536
  }
1476
1537
  },
1477
- "/custom-tools/{name}/versions/{version_name}": {
1538
+ "/custom-tools/{name}/versions/{version}": {
1478
1539
  "get": {
1479
1540
  "description": "Get a version's source, build status, and error details.",
1480
1541
  "operationId": "getCustomToolVersion",
@@ -1494,29 +1555,16 @@
1494
1555
  }
1495
1556
  },
1496
1557
  {
1497
- "description": "A numbered version handle, such as `v3`.",
1558
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1498
1559
  "in": "path",
1499
- "name": "version_name",
1560
+ "name": "version",
1500
1561
  "required": true,
1501
1562
  "schema": {
1502
- "description": "A numbered version handle, such as `v3`.",
1503
- "maxLength": 200,
1563
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1564
+ "maxLength": 512,
1504
1565
  "minLength": 2,
1505
- "pattern": "^v[1-9][0-9]*$",
1506
- "title": "Version Name",
1507
- "type": "string"
1508
- }
1509
- },
1510
- {
1511
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1512
- "in": "header",
1513
- "name": "X-Tamarind-Tool-Generation",
1514
- "required": true,
1515
- "schema": {
1516
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1517
- "maxLength": 128,
1518
- "minLength": 1,
1519
- "title": "X-Tamarind-Tool-Generation",
1566
+ "pattern": "^(?:ver_[A-Za-z0-9_-]+|v[1-9][0-9]*)$",
1567
+ "title": "Version",
1520
1568
  "type": "string"
1521
1569
  }
1522
1570
  }
@@ -1530,7 +1578,16 @@
1530
1578
  }
1531
1579
  }
1532
1580
  },
1533
- "description": "Successful Response"
1581
+ "description": "The exact Version.",
1582
+ "headers": {
1583
+ "ETag": {
1584
+ "description": "Quoted strong validator for requests that target this Version.",
1585
+ "schema": {
1586
+ "example": "\"eyJvcGFxdWUiOiJ2ZXJzaW9uIn0\"",
1587
+ "type": "string"
1588
+ }
1589
+ }
1590
+ }
1534
1591
  },
1535
1592
  "401": {
1536
1593
  "$ref": "#/components/responses/Unauthorized"
@@ -1552,7 +1609,7 @@
1552
1609
  "x-doc-group": "Custom Tools"
1553
1610
  }
1554
1611
  },
1555
- "/custom-tools/{name}/versions/{version_name}/logs": {
1612
+ "/custom-tools/{name}/versions/{version}/logs": {
1556
1613
  "get": {
1557
1614
  "description": "List build log events for a version.\n\nPaginated \u2014 follow `nextCursor` until it is null.",
1558
1615
  "operationId": "listCustomToolBuildLogs",
@@ -1572,16 +1629,16 @@
1572
1629
  }
1573
1630
  },
1574
1631
  {
1575
- "description": "A numbered version handle, such as `v3`.",
1632
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1576
1633
  "in": "path",
1577
- "name": "version_name",
1634
+ "name": "version",
1578
1635
  "required": true,
1579
1636
  "schema": {
1580
- "description": "A numbered version handle, such as `v3`.",
1581
- "maxLength": 200,
1637
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1638
+ "maxLength": 512,
1582
1639
  "minLength": 2,
1583
- "pattern": "^v[1-9][0-9]*$",
1584
- "title": "Version Name",
1640
+ "pattern": "^(?:ver_[A-Za-z0-9_-]+|v[1-9][0-9]*)$",
1641
+ "title": "Version",
1585
1642
  "type": "string"
1586
1643
  }
1587
1644
  },
@@ -1603,19 +1660,6 @@
1603
1660
  "description": "Pagination token from the previous response's `nextCursor`.",
1604
1661
  "title": "Cursor"
1605
1662
  }
1606
- },
1607
- {
1608
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1609
- "in": "header",
1610
- "name": "X-Tamarind-Tool-Generation",
1611
- "required": true,
1612
- "schema": {
1613
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1614
- "maxLength": 128,
1615
- "minLength": 1,
1616
- "title": "X-Tamarind-Tool-Generation",
1617
- "type": "string"
1618
- }
1619
1663
  }
1620
1664
  ],
1621
1665
  "responses": {
@@ -1649,9 +1693,9 @@
1649
1693
  "x-doc-group": "Custom Tools"
1650
1694
  }
1651
1695
  },
1652
- "/custom-tools/{name}/versions/{version_name}:cancel": {
1696
+ "/custom-tools/{name}/versions/{version}:cancel": {
1653
1697
  "post": {
1654
- "description": "Request cancellation of an active build.\n\nCompleted and stopped builds cannot be canceled.",
1698
+ "description": "Request cancellation of an active build.\n\nSend the current ETag from the build response or exact Version GET. Completed and stopped\nbuilds cannot be canceled.",
1655
1699
  "operationId": "cancelCustomToolBuild",
1656
1700
  "parameters": [
1657
1701
  {
@@ -1669,29 +1713,26 @@
1669
1713
  }
1670
1714
  },
1671
1715
  {
1672
- "description": "A numbered version handle, such as `v3`.",
1716
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1673
1717
  "in": "path",
1674
- "name": "version_name",
1718
+ "name": "version",
1675
1719
  "required": true,
1676
1720
  "schema": {
1677
- "description": "A numbered version handle, such as `v3`.",
1678
- "maxLength": 200,
1721
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1722
+ "maxLength": 512,
1679
1723
  "minLength": 2,
1680
- "pattern": "^v[1-9][0-9]*$",
1681
- "title": "Version Name",
1724
+ "pattern": "^(?:ver_[A-Za-z0-9_-]+|v[1-9][0-9]*)$",
1725
+ "title": "Version",
1682
1726
  "type": "string"
1683
1727
  }
1684
1728
  },
1685
1729
  {
1686
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1730
+ "description": "One or more entity-tags using standard If-Match syntax, or `*` to match any existing Version. Only strong validators can match. The ETag returned with the exact Version prevents a delayed request from cancelling a changed Version or the same numbered Version of a recreated Tool.",
1687
1731
  "in": "header",
1688
- "name": "X-Tamarind-Tool-Generation",
1732
+ "name": "If-Match",
1689
1733
  "required": true,
1690
1734
  "schema": {
1691
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1692
- "maxLength": 128,
1693
1735
  "minLength": 1,
1694
- "title": "X-Tamarind-Tool-Generation",
1695
1736
  "type": "string"
1696
1737
  }
1697
1738
  }
@@ -1705,7 +1746,16 @@
1705
1746
  }
1706
1747
  }
1707
1748
  },
1708
- "description": "Successful Response"
1749
+ "description": "The Version with cancellation requested.",
1750
+ "headers": {
1751
+ "ETag": {
1752
+ "description": "Quoted strong validator for requests that target this Version.",
1753
+ "schema": {
1754
+ "example": "\"eyJvcGFxdWUiOiJ2ZXJzaW9uIn0\"",
1755
+ "type": "string"
1756
+ }
1757
+ }
1758
+ }
1709
1759
  },
1710
1760
  "401": {
1711
1761
  "$ref": "#/components/responses/Unauthorized"
@@ -1713,9 +1763,15 @@
1713
1763
  "404": {
1714
1764
  "$ref": "#/components/responses/NotFound"
1715
1765
  },
1766
+ "412": {
1767
+ "$ref": "#/components/responses/PreconditionFailed"
1768
+ },
1716
1769
  "422": {
1717
1770
  "$ref": "#/components/responses/ValidationProblem"
1718
1771
  },
1772
+ "428": {
1773
+ "$ref": "#/components/responses/PreconditionRequired"
1774
+ },
1719
1775
  "default": {
1720
1776
  "$ref": "#/components/responses/Error"
1721
1777
  }
@@ -1727,7 +1783,7 @@
1727
1783
  "x-doc-group": "Custom Tools"
1728
1784
  }
1729
1785
  },
1730
- "/custom-tools/{name}/versions/{version_name}:publish": {
1786
+ "/custom-tools/{name}/versions/{version}:publish": {
1731
1787
  "post": {
1732
1788
  "description": "Make a completed version the tool's published runtime version.\n\nThis also supports an explicit rollback to an older completed version.",
1733
1789
  "operationId": "publishCustomToolVersion",
@@ -1747,29 +1803,26 @@
1747
1803
  }
1748
1804
  },
1749
1805
  {
1750
- "description": "A numbered version handle, such as `v3`.",
1806
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1751
1807
  "in": "path",
1752
- "name": "version_name",
1808
+ "name": "version",
1753
1809
  "required": true,
1754
1810
  "schema": {
1755
- "description": "A numbered version handle, such as `v3`.",
1756
- "maxLength": 200,
1811
+ "description": "The opaque Version `id` returned in a Version representation. Numbered names remain accepted for previously generated v1 clients when paired with their generation header.",
1812
+ "maxLength": 512,
1757
1813
  "minLength": 2,
1758
- "pattern": "^v[1-9][0-9]*$",
1759
- "title": "Version Name",
1814
+ "pattern": "^(?:ver_[A-Za-z0-9_-]+|v[1-9][0-9]*)$",
1815
+ "title": "Version",
1760
1816
  "type": "string"
1761
1817
  }
1762
1818
  },
1763
1819
  {
1764
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1820
+ "description": "One or more entity-tags using standard If-Match syntax, or `*` to match any existing Tool. Only strong validators can match. The ETag returned with the Tool prevents stale requests from acting on a changed, deleted, or recreated Tool with the same name.",
1765
1821
  "in": "header",
1766
- "name": "X-Tamarind-Tool-Generation",
1822
+ "name": "If-Match",
1767
1823
  "required": true,
1768
1824
  "schema": {
1769
- "description": "The immutable generation returned as `generation` by the Tool resource. It prevents a stale request from acting on a deleted and recreated Tool with the same name.",
1770
- "maxLength": 128,
1771
1825
  "minLength": 1,
1772
- "title": "X-Tamarind-Tool-Generation",
1773
1826
  "type": "string"
1774
1827
  }
1775
1828
  }
@@ -1783,7 +1836,16 @@
1783
1836
  }
1784
1837
  }
1785
1838
  },
1786
- "description": "Successful Response"
1839
+ "description": "The Tool with its published version updated.",
1840
+ "headers": {
1841
+ "ETag": {
1842
+ "description": "Quoted strong validator for requests that target this Tool.",
1843
+ "schema": {
1844
+ "example": "\"01JABCDEF0123456789XYZ\"",
1845
+ "type": "string"
1846
+ }
1847
+ }
1848
+ }
1787
1849
  },
1788
1850
  "401": {
1789
1851
  "$ref": "#/components/responses/Unauthorized"
@@ -1791,9 +1853,15 @@
1791
1853
  "404": {
1792
1854
  "$ref": "#/components/responses/NotFound"
1793
1855
  },
1856
+ "412": {
1857
+ "$ref": "#/components/responses/PreconditionFailed"
1858
+ },
1794
1859
  "422": {
1795
1860
  "$ref": "#/components/responses/ValidationProblem"
1796
1861
  },
1862
+ "428": {
1863
+ "$ref": "#/components/responses/PreconditionRequired"
1864
+ },
1797
1865
  "default": {
1798
1866
  "$ref": "#/components/responses/Error"
1799
1867
  }