zenture 1.0.1__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 (174) hide show
  1. zenture-1.0.1/.gitignore +11 -0
  2. zenture-1.0.1/AGENTS.md +173 -0
  3. zenture-1.0.1/CHANGELOG.md +114 -0
  4. zenture-1.0.1/CODE_OF_CONDUCT.md +14 -0
  5. zenture-1.0.1/CONTRIBUTING.md +85 -0
  6. zenture-1.0.1/LICENSE +201 -0
  7. zenture-1.0.1/NOTICE +7 -0
  8. zenture-1.0.1/PKG-INFO +804 -0
  9. zenture-1.0.1/README.md +761 -0
  10. zenture-1.0.1/SECURITY.md +74 -0
  11. zenture-1.0.1/THIRD_PARTY_NOTICES.md +83 -0
  12. zenture-1.0.1/docs/account-reads.md +69 -0
  13. zenture-1.0.1/docs/api-reference.md +232 -0
  14. zenture-1.0.1/docs/assets/zenture-logo.svg +87 -0
  15. zenture-1.0.1/docs/async-operations.md +100 -0
  16. zenture-1.0.1/docs/authentication.md +161 -0
  17. zenture-1.0.1/docs/errors.md +119 -0
  18. zenture-1.0.1/docs/idempotency.md +80 -0
  19. zenture-1.0.1/docs/mcp-client.md +210 -0
  20. zenture-1.0.1/docs/migration.md +99 -0
  21. zenture-1.0.1/docs/pagination.md +50 -0
  22. zenture-1.0.1/docs/rate-limits.md +29 -0
  23. zenture-1.0.1/docs/release.md +24 -0
  24. zenture-1.0.1/docs/response-shapes.md +1353 -0
  25. zenture-1.0.1/docs/run-guide.md +261 -0
  26. zenture-1.0.1/docs/sdk-call-reference.md +1025 -0
  27. zenture-1.0.1/docs/security.md +33 -0
  28. zenture-1.0.1/examples/account_status.py +20 -0
  29. zenture-1.0.1/examples/async_chat.py +24 -0
  30. zenture-1.0.1/examples/async_evaluate.py +25 -0
  31. zenture-1.0.1/examples/chat_multi.py +29 -0
  32. zenture-1.0.1/examples/chat_single.py +22 -0
  33. zenture-1.0.1/examples/end_to_end_chat_evaluation.py +153 -0
  34. zenture-1.0.1/examples/error_handling.py +29 -0
  35. zenture-1.0.1/examples/evaluate.py +120 -0
  36. zenture-1.0.1/examples/helloworld.py +14 -0
  37. zenture-1.0.1/examples/idempotency.py +21 -0
  38. zenture-1.0.1/examples/input_wizard.py +35 -0
  39. zenture-1.0.1/examples/list_models.py +30 -0
  40. zenture-1.0.1/examples/mcp_async_login.py +33 -0
  41. zenture-1.0.1/examples/mcp_device_login.py +34 -0
  42. zenture-1.0.1/examples/mcp_run_review.py +59 -0
  43. zenture-1.0.1/examples/mcp_sync_stored_login.py +38 -0
  44. zenture-1.0.1/examples/operation_polling.py +22 -0
  45. zenture-1.0.1/examples/pagination.py +15 -0
  46. zenture-1.0.1/examples/run_review.py +38 -0
  47. zenture-1.0.1/openapi/zenture-public-api-v1.openapi.json +10675 -0
  48. zenture-1.0.1/pyproject.toml +108 -0
  49. zenture-1.0.1/src/zenture/__init__.py +9 -0
  50. zenture-1.0.1/src/zenture/_auth/__init__.py +1 -0
  51. zenture-1.0.1/src/zenture/_auth/browser.py +262 -0
  52. zenture-1.0.1/src/zenture/_auth/device.py +224 -0
  53. zenture-1.0.1/src/zenture/_auth/discovery.py +93 -0
  54. zenture-1.0.1/src/zenture/_auth/errors.py +59 -0
  55. zenture-1.0.1/src/zenture/_auth/http.py +59 -0
  56. zenture-1.0.1/src/zenture/_auth/http_auth.py +75 -0
  57. zenture-1.0.1/src/zenture/_auth/lock.py +106 -0
  58. zenture-1.0.1/src/zenture/_auth/login.py +292 -0
  59. zenture-1.0.1/src/zenture/_auth/model.py +81 -0
  60. zenture-1.0.1/src/zenture/_auth/session.py +249 -0
  61. zenture-1.0.1/src/zenture/_auth/store.py +236 -0
  62. zenture-1.0.1/src/zenture/_auth/stored.py +114 -0
  63. zenture-1.0.1/src/zenture/_auth/tokens.py +186 -0
  64. zenture-1.0.1/src/zenture/_contract/__init__.py +138 -0
  65. zenture-1.0.1/src/zenture/_contract/headers.py +17 -0
  66. zenture-1.0.1/src/zenture/_contract/models.py +1254 -0
  67. zenture-1.0.1/src/zenture/_contract/run_references.py +43 -0
  68. zenture-1.0.1/src/zenture/_mcp/__init__.py +6 -0
  69. zenture-1.0.1/src/zenture/_mcp/catalog.py +136 -0
  70. zenture-1.0.1/src/zenture/_mcp/client.py +1153 -0
  71. zenture-1.0.1/src/zenture/_mcp/contracts.py +253 -0
  72. zenture-1.0.1/src/zenture/_mcp/transport.py +230 -0
  73. zenture-1.0.1/src/zenture/_mcp/wait.py +134 -0
  74. zenture-1.0.1/src/zenture/_request_validation.py +46 -0
  75. zenture-1.0.1/src/zenture/_resources/__init__.py +43 -0
  76. zenture-1.0.1/src/zenture/_resources/_utils.py +110 -0
  77. zenture-1.0.1/src/zenture/_resources/account.py +94 -0
  78. zenture-1.0.1/src/zenture/_resources/async_runs.py +782 -0
  79. zenture-1.0.1/src/zenture/_resources/chat.py +521 -0
  80. zenture-1.0.1/src/zenture/_resources/evaluations.py +368 -0
  81. zenture-1.0.1/src/zenture/_resources/helloworld.py +32 -0
  82. zenture-1.0.1/src/zenture/_resources/input_wizard.py +136 -0
  83. zenture-1.0.1/src/zenture/_resources/models.py +47 -0
  84. zenture-1.0.1/src/zenture/_resources/operations.py +141 -0
  85. zenture-1.0.1/src/zenture/_resources/runs.py +1074 -0
  86. zenture-1.0.1/src/zenture/_transport/__init__.py +8 -0
  87. zenture-1.0.1/src/zenture/_transport/async_.py +338 -0
  88. zenture-1.0.1/src/zenture/_transport/base.py +143 -0
  89. zenture-1.0.1/src/zenture/_transport/sync.py +337 -0
  90. zenture-1.0.1/src/zenture/_version.py +5 -0
  91. zenture-1.0.1/src/zenture/async_client.py +142 -0
  92. zenture-1.0.1/src/zenture/auth/__init__.py +58 -0
  93. zenture-1.0.1/src/zenture/cli.py +294 -0
  94. zenture-1.0.1/src/zenture/client.py +142 -0
  95. zenture-1.0.1/src/zenture/config.py +184 -0
  96. zenture-1.0.1/src/zenture/errors.py +266 -0
  97. zenture-1.0.1/src/zenture/idempotency.py +53 -0
  98. zenture-1.0.1/src/zenture/mcp/__init__.py +13 -0
  99. zenture-1.0.1/src/zenture/models.py +49 -0
  100. zenture-1.0.1/src/zenture/polling.py +108 -0
  101. zenture-1.0.1/src/zenture/py.typed +1 -0
  102. zenture-1.0.1/src/zenture/rate_limits.py +53 -0
  103. zenture-1.0.1/src/zenture/redaction.py +38 -0
  104. zenture-1.0.1/src/zenture/retries.py +57 -0
  105. zenture-1.0.1/src/zenture/testing/__init__.py +9 -0
  106. zenture-1.0.1/src/zenture/testing/product_runs.py +158 -0
  107. zenture-1.0.1/src/zenture/types.py +75 -0
  108. zenture-1.0.1/src/zenture/validation_issues.py +168 -0
  109. zenture-1.0.1/src/zenture/validation_projection.py +168 -0
  110. zenture-1.0.1/tests/e2e/test_cross_channel_client_composition.py +99 -0
  111. zenture-1.0.1/tests/e2e/test_external_run_acceptance.py +160 -0
  112. zenture-1.0.1/tests/e2e/test_product_run_sdk_acceptance.py +75 -0
  113. zenture-1.0.1/tests/integration/auth/auth_harness.py +630 -0
  114. zenture-1.0.1/tests/integration/auth/client_worker.py +53 -0
  115. zenture-1.0.1/tests/integration/auth/conftest.py +37 -0
  116. zenture-1.0.1/tests/integration/auth/file_store.py +46 -0
  117. zenture-1.0.1/tests/integration/auth/refresh_worker.py +48 -0
  118. zenture-1.0.1/tests/integration/auth/test_access_token_verification.py +98 -0
  119. zenture-1.0.1/tests/integration/auth/test_auth_secret_hygiene.py +70 -0
  120. zenture-1.0.1/tests/integration/auth/test_binding_change.py +45 -0
  121. zenture-1.0.1/tests/integration/auth/test_browser_login.py +627 -0
  122. zenture-1.0.1/tests/integration/auth/test_cli.py +455 -0
  123. zenture-1.0.1/tests/integration/auth/test_cli_mcp_processes.py +75 -0
  124. zenture-1.0.1/tests/integration/auth/test_device_login.py +412 -0
  125. zenture-1.0.1/tests/integration/auth/test_discovery.py +75 -0
  126. zenture-1.0.1/tests/integration/auth/test_login_reuse.py +220 -0
  127. zenture-1.0.1/tests/integration/auth/test_mcp_auth.py +211 -0
  128. zenture-1.0.1/tests/integration/auth/test_public_mcp.py +253 -0
  129. zenture-1.0.1/tests/integration/auth/test_refresh.py +282 -0
  130. zenture-1.0.1/tests/integration/auth/test_resource_binding.py +137 -0
  131. zenture-1.0.1/tests/integration/contract/test_contract_models.py +661 -0
  132. zenture-1.0.1/tests/integration/contract/test_header_validation_issues.py +236 -0
  133. zenture-1.0.1/tests/integration/contract/test_mcp_catalog_registration.py +100 -0
  134. zenture-1.0.1/tests/integration/contract/test_mcp_client_contract.py +33 -0
  135. zenture-1.0.1/tests/integration/contract/test_mcp_validation_issues.py +84 -0
  136. zenture-1.0.1/tests/integration/contract/test_mcp_wait_transport.py +78 -0
  137. zenture-1.0.1/tests/integration/contract/test_openapi_contract.py +193 -0
  138. zenture-1.0.1/tests/unit/auth/test_import_side_effects.py +110 -0
  139. zenture-1.0.1/tests/unit/auth/test_lock_directory.py +75 -0
  140. zenture-1.0.1/tests/unit/auth/test_packaging.py +89 -0
  141. zenture-1.0.1/tests/unit/auth/test_store.py +210 -0
  142. zenture-1.0.1/tests/unit/test_auth_docs_contract.py +317 -0
  143. zenture-1.0.1/tests/unit/test_client.py +168 -0
  144. zenture-1.0.1/tests/unit/test_config.py +248 -0
  145. zenture-1.0.1/tests/unit/test_docs_examples.py +521 -0
  146. zenture-1.0.1/tests/unit/test_end_to_end_example_totals.py +67 -0
  147. zenture-1.0.1/tests/unit/test_error_details_negotiation.py +172 -0
  148. zenture-1.0.1/tests/unit/test_errors.py +123 -0
  149. zenture-1.0.1/tests/unit/test_example_output_defaults.py +102 -0
  150. zenture-1.0.1/tests/unit/test_examples.py +67 -0
  151. zenture-1.0.1/tests/unit/test_idempotency.py +35 -0
  152. zenture-1.0.1/tests/unit/test_installed_cli_package.py +150 -0
  153. zenture-1.0.1/tests/unit/test_mcp_auth_classification.py +120 -0
  154. zenture-1.0.1/tests/unit/test_mcp_catalog.py +279 -0
  155. zenture-1.0.1/tests/unit/test_mcp_client.py +1457 -0
  156. zenture-1.0.1/tests/unit/test_mcp_optional_issues.py +118 -0
  157. zenture-1.0.1/tests/unit/test_mcp_run_identity.py +301 -0
  158. zenture-1.0.1/tests/unit/test_mcp_validation_privacy.py +119 -0
  159. zenture-1.0.1/tests/unit/test_mcp_wait.py +332 -0
  160. zenture-1.0.1/tests/unit/test_package_bootstrap.py +79 -0
  161. zenture-1.0.1/tests/unit/test_package_install.py +89 -0
  162. zenture-1.0.1/tests/unit/test_polling.py +51 -0
  163. zenture-1.0.1/tests/unit/test_rate_limits.py +60 -0
  164. zenture-1.0.1/tests/unit/test_redaction.py +40 -0
  165. zenture-1.0.1/tests/unit/test_resources.py +2134 -0
  166. zenture-1.0.1/tests/unit/test_retries.py +70 -0
  167. zenture-1.0.1/tests/unit/test_run_e2e_adapter.py +183 -0
  168. zenture-1.0.1/tests/unit/test_run_guide_examples.py +259 -0
  169. zenture-1.0.1/tests/unit/test_run_helper_start_parity.py +212 -0
  170. zenture-1.0.1/tests/unit/test_run_predecessor.py +250 -0
  171. zenture-1.0.1/tests/unit/test_runs.py +2823 -0
  172. zenture-1.0.1/tests/unit/test_safe_result_content_contract.py +113 -0
  173. zenture-1.0.1/tests/unit/test_transport.py +1043 -0
  174. zenture-1.0.1/tests/unit/test_validation_issues.py +218 -0
@@ -0,0 +1,11 @@
1
+ .coverage
2
+ .mypy_cache/
3
+ .pytest_cache/
4
+ .ruff_cache/
5
+ .venv/
6
+ __pycache__/
7
+ *.py[cod]
8
+ dist/
9
+ build/
10
+ *.egg-info/
11
+ scratch/
@@ -0,0 +1,173 @@
1
+ # AGENTS.md
2
+
3
+ Purpose: onboard contributors and coding agents to the official Python client
4
+ for the zenture REST API and hosted MCP endpoint.
5
+
6
+ ## Repository Purpose
7
+
8
+ `zenture-client` is the official server-side Python REST client and the
9
+ implementation home for hosted MCP peers and explicit native authentication.
10
+ The default installation includes REST, MCP, native auth, and the `zenture`
11
+ command; no extra is required. API tokens are REST-only, account OAuth is
12
+ MCP-only, and Backend/Engine retain authorization, execution, billing, and
13
+ tenant authority. The package provides no local MCP server. It is intended
14
+ for backend services, workers, automation jobs, CI, evaluation pipelines, controlled
15
+ notebooks and governed MCP-consuming clients. It is not for browsers, mobile
16
+ apps, or frontend bundles.
17
+
18
+ Package names:
19
+
20
+ - Distribution: `zenture`
21
+ - Import package: `zenture`
22
+ - Sync client: `ZentureClient`
23
+ - Async client: `AsyncZentureClient`
24
+
25
+ Public product references:
26
+
27
+ - Users create API tokens at `https://ai.zenture.app/profile?tab=api-tokens`.
28
+ - Human-facing API documentation lives at
29
+ `https://www.zenture.app/developers`.
30
+ - The committed `openapi/zenture-public-api-v1.openapi.json` file remains the
31
+ SDK-local contract source of truth for implementation and drift tests.
32
+
33
+ ## Architecture Map
34
+
35
+ - `src/zenture/client.py` and `src/zenture/async_client.py`: public clients.
36
+ - `src/zenture/_resources/`: private resource implementation classes backing
37
+ public `client.<resource>` attributes for operations, chat, input wizard,
38
+ evaluations, models, billing, usage, limits, and helloworld.
39
+ - `src/zenture/_transport/`: private sync/async `httpx` transport layer.
40
+ - `src/zenture/auth/`: public explicit login (`login`, `login_async`) and the
41
+ auth errors; implementation in private `src/zenture/_auth/`.
42
+ - `src/zenture/mcp/`: public `McpClient` / `AsyncMcpClient`; implementation in
43
+ private `src/zenture/_mcp/` (transport ports, official Streamable HTTP binding,
44
+ typed Run adapter). It owns no Backend, Engine or persistence authority.
45
+ - `src/zenture/cli.py`: the `zenture auth login|status|clear` command.
46
+ - `src/zenture/_contract/`: internal OpenAPI-derived Pydantic models.
47
+ - `src/zenture/errors.py`: typed SDK exceptions.
48
+ - `src/zenture/polling.py`: polling policy primitives.
49
+ - `src/zenture/retries.py`: retry decision policy.
50
+ - `src/zenture/idempotency.py`: idempotency-key helpers.
51
+ - `src/zenture/redaction.py`: secret redaction helpers.
52
+
53
+ ## Public vs Internal Surface
54
+
55
+ Only `ZentureClient`, `AsyncZentureClient`, and `__version__` are top-level
56
+ public exports.
57
+ Do not export internal `_contract` models from `zenture.__init__`.
58
+
59
+ Public MCP/auth surface: `zenture.auth` (`login`, `login_async`, `AuthSession`,
60
+ `AuthorizationRequired`, `AuthUnavailable`, `SecureStoreUnavailable`,
61
+ `PermissionDenied`, `LoginCancelled`), `zenture.mcp` (`McpClient`,
62
+ `AsyncMcpClient`) and the `zenture` command. `_auth`, `_mcp` and similar
63
+ underscore namespaces are implementation details.
64
+
65
+ Resource methods such as `client.chat.run(...)`, `client.models.list(...)`, and
66
+ `client.operations.wait(...)` are the ergonomic public API. `_transport`,
67
+ `_resources`, and `_contract` are implementation namespaces even when tests
68
+ import them.
69
+
70
+ ## Contract drift
71
+
72
+ The OpenAPI artifact in `openapi/zenture-public-api-v1.openapi.json` is the
73
+ local contract source of truth. Contract tests under
74
+ `tests/integration/contract/` verify operation statuses, error codes, bounded
75
+ operation result shapes, idempotency header constraints, and excluded
76
+ user-session routes.
77
+
78
+ Use `https://www.zenture.app/developers` for human-facing API context,
79
+ but do not implement SDK behavior from website prose unless the local OpenAPI
80
+ artifact and drift tests agree.
81
+
82
+ When adding or changing a resource:
83
+
84
+ - Confirm the route exists in OpenAPI.
85
+ - Add or update internal Pydantic contract models.
86
+ - Add contract drift tests where the schema meaning matters.
87
+ - Add sync and async resource tests using `httpx.MockTransport`.
88
+ - Keep examples and docs aligned with the public surface.
89
+
90
+ When a new Engine capability is intended for client consumption, extend this
91
+ repository's canonical contract models and both peer surfaces: the API
92
+ resource and the hosted MCP peers. Add sync/async parity and cross-channel
93
+ acceptance tests here before release promotion; do not create a workspace-only client duplicate or move Engine/business authority into the
94
+ SDK.
95
+
96
+ ## Using zenture as an agent
97
+
98
+ Contracts: [`README.md`](./README.md) (quickstart, errors, exit codes),
99
+ [`docs/authentication.md`](./docs/authentication.md),
100
+ [`docs/mcp-client.md`](./docs/mcp-client.md), and
101
+ [`docs/migration.md`](./docs/migration.md) (uninstall-first upgrade and published
102
+ return baseline).
103
+
104
+ - Check the connection with `zenture auth status` (exit code 0 means connected).
105
+ Only a human at a terminal should run `zenture auth login`; explain what is
106
+ needed and stop instead of logging in on the user's behalf.
107
+ - no implicit login: call `McpClient.connect()` / `AsyncMcpClient.connect()` with
108
+ the stored authorization and handle `AuthorizationRequired` by reporting
109
+ "run `zenture auth login`".
110
+ - no private imports: use `zenture`, `zenture.auth`, `zenture.mcp` only, never
111
+ underscore modules of the package.
112
+ - never print, log, store or paste tokens, refresh credentials, codes or
113
+ authorization URLs. Session objects are safe to print; do not try to extract
114
+ credentials from them.
115
+ - Sync `McpClient` must not run inside a running event loop; use `AsyncMcpClient`.
116
+ - Do not use `zenture auth clear` to revoke access; it is local only. Revocation
117
+ happens in zenture under Zugriff & Sicherheit -> Verbindungen.
118
+ - Save a caller-owned `run(idempotency_key=...)` key before dispatch when a Run
119
+ must survive interruption or restart. Reuse that key and the same request for
120
+ deliberate recovery; never switch to a new key after an uncertain outcome.
121
+ Read `run.idempotency_key` or `ZentureMCPError.idempotency_key` separately from
122
+ model serialization; do not log keys or treat receipts as effect evidence.
123
+
124
+ ## Required Commands
125
+
126
+ ```bash
127
+ python3 -m ruff format --check .
128
+ python3 -m ruff check .
129
+ python3 -m mypy
130
+ python3 -m pyright
131
+ python3 -m pytest
132
+ python3 -m coverage run -m pytest
133
+ python3 -m coverage report
134
+ python3 -m build
135
+ python3 -m twine check dist/*
136
+ ```
137
+
138
+ Remove local artifacts after verification: `.coverage`, `.pytest_cache`,
139
+ `.ruff_cache`, `.mypy_cache`, `dist/`, and `__pycache__/`.
140
+
141
+ ## Security Red Lines
142
+
143
+ - no token logging
144
+ - no token literals in examples, docs, tests, or issue text
145
+ - no arbitrary base URL origins
146
+ - no API-token-management SDK resource
147
+ - no public helper for agentic chat mode in Public V1
148
+ - no internal `_contract` top-level exports
149
+ - no request or response body logging by default
150
+ - no private infrastructure details in public docs
151
+
152
+ ## Contribution Expectations
153
+
154
+ New resources must include typed sync and async behavior, idempotency safety for
155
+ mutating calls, no real network tests, and public-safe docs/examples when the
156
+ usage surface changes.
157
+
158
+ Examples must use `ZentureClient.from_env()` or `AsyncZentureClient.from_env()` for REST
159
+ and the documented auth/MCP public APIs (`zenture.auth`, `zenture.mcp`) for sign-in and MCP.
160
+ Mutating examples must pass explicit stable idempotency keys, preferably built with the
161
+ SDK helper. Do not create tracked `.env` files.
162
+
163
+ ## Pull Request Rules
164
+
165
+ Use one primary PR type: `type: fix`, `type: feat`, `type: docs`,
166
+ `type: test`, `type: chore`, `type: refactor`, or `type: security`.
167
+
168
+ Every PR must keep public docs production-relevant, avoid internal routes, avoid
169
+ real token patterns, and preserve the private/public package boundary. Public
170
+ API changes require matching tests, README/docs updates, and changelog coverage.
171
+
172
+ Required review posture: small focused PRs, `Development CI` green, CODEOWNERS
173
+ review once branch protection is available, and squash merge only.
@@ -0,0 +1,114 @@
1
+ # Changelog
2
+
3
+ All notable changes to `zenture` will be documented in this file.
4
+
5
+ The project follows semantic versioning once public releases begin. Prerelease
6
+ versions may change while the Public API contract is still in release-candidate
7
+ state.
8
+
9
+ ## 1.0.1 - 2026-10-10
10
+
11
+ - Documentation leads with Runs; the classic API resources are documented as secondary.
12
+
13
+ - MCP peers keep authorization failures (`AuthorizationRequired`,
14
+ `PermissionDenied`, including inside an `ExceptionGroup`) classified and
15
+ do not retry them in `wait_run` or discovery; only unknown transport failures
16
+ are wrapped as retryable `mcp_transport_unavailable`.
17
+
18
+ - MCP result-contract errors no longer chain the Pydantic validation error, so
19
+ submitted values do not appear in tracebacks.
20
+
21
+ - The MCP run review example uses `wait_run` under one caller budget that also
22
+ covers the final full read; a late completion raises `ZenturePollingTimeoutError`.
23
+
24
+ - The end-to-end example reports a billed total only when every component is
25
+ known, and names the operations included in each total.
26
+
27
+ - Documented `wait_run` on both MCP peers and clarified that MCP `run()` only
28
+ starts a Run. Documented in-process `login(session_only=True)`; the CLI
29
+ `--session-only` option is verification only. PyPI publication requires
30
+ Trusted Publishing without a long-lived token fallback.
31
+
32
+ - Examples print identifiers and status by default; evaluation results and the
33
+ optimized prompt require `--show-result` / `--show-prompt`.
34
+
35
+ - Added immutable typed validation `issues` on REST and MCP errors, bounded by
36
+ public field schemas, and content-free local Run `ValidationError` summaries.
37
+ Sync/async REST Run and artifact requests automatically negotiate safe details
38
+ with `X-Zenture-Error-Details: issues`; older servers remain supported.
39
+
40
+ - Added sync/async `get_tool_catalog()` and public `zenture.mcp.McpToolDefinition`
41
+ for detached registered schemas, descriptions and annotations, with bounded
42
+ complete pagination. Existing name-only `list_tools()` behavior is preserved.
43
+
44
+ - MCP Run peers now allocate or accept a strict caller-owned idempotency key and
45
+ expose validated Run-only success/error receipts for deliberate recovery.
46
+ Save an explicit key before interruption; default model serialization and
47
+ REST models retain their existing shape.
48
+
49
+ - Rename the repository to `zenture-client`, the distribution to `zenture`, and
50
+ public API classes to `ZentureClient` / `AsyncZentureClient` without aliases.
51
+ - Preserve API-token resource behavior and caller-provided bearer MCP support;
52
+ Public package publication remains outside this source cutover.
53
+ - Added native authorization for the hosted MCP endpoint: explicit browser
54
+ (PKCE, loopback) and headless device login through `zenture.auth.login` /
55
+ `login_async`, secure credential storage (macOS Keychain proven; Windows
56
+ Credential Manager and Linux Secret Service implemented, not yet verified)
57
+ with a session-only mode, and safe refresh that requires a new login after an
58
+ interrupted refresh.
59
+ - Added the `zenture` command: `zenture auth login [--device] [--session-only]`,
60
+ `zenture auth status` and `zenture auth clear` with documented exit codes.
61
+ - Added the public `zenture.mcp` module with `McpClient` and `AsyncMcpClient`
62
+ exposing the six Run tools; the former `zenture._mcp` path is internal and no
63
+ alias exists (hard cutover).
64
+ - Declared CPython 3.14 support and configured the CI matrix for 3.11 to 3.14
65
+ across Linux, macOS and Windows (configured, not yet run).
66
+
67
+ - Added nullable `deadline_at` Run response fields, additive response tolerance,
68
+ and finite sync/async Run waits with deadline-aware timeout context.
69
+ - Added an opt-in, internal MCP client peer adapter with sync/async transport
70
+ ports, official Streamable HTTP integration, typed Run mappings, bounded safe
71
+ errors and local cross-channel composition tests. The API-only installation
72
+ remains unchanged; public `zenture-client` promotion is deferred.
73
+
74
+ ## 1.0.0rc3 - 2026-06-28
75
+
76
+ - Clarified external vs. internal evaluation flows across SDK docs.
77
+ - Added local SDK validation for internal evaluation target payloads.
78
+ - Updated evaluation error handling docs for local `ValidationError` and API
79
+ `ZentureValidationError`.
80
+
81
+ ## 1.0.0rc2 - 2026-06-27
82
+
83
+ - Updated the README logo to use the public production-hosted zenture logo so
84
+ PyPI renders the project description correctly.
85
+
86
+ ## 1.0.0rc1 - 2026-06-27
87
+
88
+ - Added `client.wallet.get()` and `await client.wallet.get()` for the public
89
+ `GET /v1/wallet` account projection with `wallet:read` scope.
90
+ - Removed the unpublished `client.billing.get()` mapping and `/v1/billing`
91
+ SDK surface in favor of wallet terminology before public release.
92
+ - Added optional `chat.run(..., include_content=True)` and
93
+ `evaluations.run(..., include_detail=True)` attachments for common
94
+ chat-then-evaluate application flows.
95
+ - Added an end-to-end chat evaluation smoke example with wallet, model
96
+ discovery, input wizard, chat, evaluation, and billed-amount summary output.
97
+ - Synced the Public API OpenAPI artifact with pagination parameters for chats,
98
+ chat messages, and evaluations.
99
+ - Added `limit` and `cursor` support plus sync/async iterator helpers for chat
100
+ summaries, chat messages, and evaluations.
101
+ - Added pagination documentation and an executable pagination example.
102
+ - Updated operation-error contract handling to match the current OpenAPI
103
+ `PublicOperationError` schema.
104
+
105
+ ## 0.1.0b1 - 2026-06-15
106
+
107
+ - Added SDK architecture and implementation plan.
108
+ - Added repository governance bootstrap documents.
109
+ - Added public sync/async clients, private httpx transport, strict contract
110
+ models, model discovery, single-/multi-model chat, evaluation creation,
111
+ operation reads, billing, usage, limits, idempotency, retry, timeout and
112
+ polling primitives.
113
+
114
+ - Add sync/async MCP `wait_run` with finite deadlines, same-Run summary observation, safe read retries and official per-call read budgets.
@@ -0,0 +1,14 @@
1
+ # Code of Conduct
2
+
3
+ zenture SDK contributors are expected to participate professionally, respectfully,
4
+ and constructively.
5
+
6
+ Unacceptable behavior includes harassment, abusive comments, intimidation,
7
+ disruptive conduct, publishing private information without permission, or any
8
+ behavior that makes the project unsafe for maintainers or contributors.
9
+
10
+ Maintainers may remove comments, reject contributions, restrict participation, or
11
+ take other action needed to protect the project.
12
+
13
+ Security issues must be reported through the private process described in
14
+ `SECURITY.md`, not through public issues or pull requests.
@@ -0,0 +1,85 @@
1
+ # Contributing
2
+
3
+ `zenture-client` provides the public `zenture` Python SDK for the zenture Public API. The current
4
+ repository contains the runtime SDK, typed contract layer, public docs,
5
+ examples, and packaging configuration used for prerelease validation.
6
+
7
+ ## Development Standards
8
+
9
+ - Keep public APIs typed and exposed through `ZentureClient`, `AsyncZentureClient`, and
10
+ resource attributes such as `client.chat`.
11
+ - Keep `_transport`, `_resources`, and `_contract` as implementation
12
+ namespaces.
13
+ - Use Pydantic models for request, response, and configuration validation.
14
+ - Use `httpx` for sync and async HTTP transport.
15
+ - Do not log secrets, prompts, raw request bodies, or raw response bodies.
16
+ - Add deterministic tests for behavior changes.
17
+ - Keep README, docs, examples, and `AGENTS.md` aligned when public behavior
18
+ changes.
19
+ - Maintainers may run controlled non-production checks using the private
20
+ environment runbook. Do not commit non-production hostnames, local port
21
+ conventions, tokens, payloads, or logs.
22
+
23
+ ## Pull Requests
24
+
25
+ All changes should go through a pull request into `main`. Keep pull requests
26
+ small and reviewable: one topic per PR, no unrelated formatting churn, and no
27
+ mixed feature/security/release work.
28
+
29
+ Pull requests should include:
30
+
31
+ - a concise description of the change
32
+ - tests or a clear reason tests are not applicable
33
+ - documentation updates when behavior, public API, security posture, examples,
34
+ or release process changes
35
+ - confirmation that no real zenture API tokens or customer data were added
36
+
37
+ Use one primary PR type:
38
+
39
+ - `type: fix` - bug fix or incorrect SDK behavior
40
+ - `type: feat` - new public SDK capability
41
+ - `type: docs` - README, examples, AGENTS, changelog, or prose docs
42
+ - `type: test` - tests only
43
+ - `type: chore` - CI, packaging, metadata, dependency upkeep
44
+ - `type: refactor` - internal change with no public behavior change
45
+ - `type: security` - security hardening or vulnerability fix
46
+
47
+ Public-surface changes require extra care. Any change to `ZentureClient`,
48
+ `AsyncZentureClient`, public resources, public errors, return types, examples, or
49
+ OpenAPI-derived contract behavior must update tests and docs in the same PR.
50
+ Breaking changes are not allowed in V1 without an explicit release decision,
51
+ migration note, and changelog entry.
52
+
53
+ Before merge:
54
+
55
+ - `Development CI` must pass.
56
+ - CODEOWNERS review must be satisfied once branch protection is available.
57
+ - Security, docs, and artifact checklist items in the PR template must be
58
+ answered truthfully.
59
+ - Use squash merge only; the PR title becomes the commit title.
60
+ - Delete the branch after merge.
61
+
62
+ ## Local Checks
63
+
64
+ Run the full local gate before handing off SDK changes:
65
+
66
+ ```bash
67
+ python3 -m ruff format --check .
68
+ python3 -m ruff check .
69
+ python3 -m mypy
70
+ python3 -m pyright
71
+ python3 -m pytest
72
+ python3 -m coverage run -m pytest
73
+ python3 -m coverage report
74
+ python3 -m build
75
+ python3 -m twine check dist/*
76
+ ```
77
+
78
+ Tests must not hit the real zenture API. Use `httpx.MockTransport` or static
79
+ checks for docs and examples.
80
+
81
+ ## Release Process
82
+
83
+ Public PyPI releases are blocked until the SDK reviewer gate passes. Publishing
84
+ must use PyPI Trusted Publishing through GitHub Actions OIDC, not long-lived
85
+ package tokens.
zenture-1.0.1/LICENSE ADDED
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for reasonable and customary use in describing the
141
+ origin of the Work and reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Additional Liability. While redistributing
166
+ the Work or Derivative Works thereof, You may choose to offer,
167
+ and charge a fee for, acceptance of support, warranty, indemnity,
168
+ or other liability obligations and/or rights consistent with this
169
+ License. However, in accepting such obligations, You may act only
170
+ on Your own behalf and on Your sole responsibility, not on behalf
171
+ of any other Contributor, and only if You agree to indemnify,
172
+ defend, and hold each Contributor harmless for any liability
173
+ incurred by, or claims asserted against, such Contributor by reason
174
+ of your accepting any such warranty or additional liability.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright 2026 zenture UG (haftungsbeschraenkt)
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.
zenture-1.0.1/NOTICE ADDED
@@ -0,0 +1,7 @@
1
+ zenture SDK
2
+ Copyright 2026 zenture UG (haftungsbeschraenkt)
3
+
4
+ This product includes software developed by zenture UG (haftungsbeschraenkt).
5
+
6
+ Third-party dependency license information is documented in
7
+ THIRD_PARTY_NOTICES.md.