matelab-python-sdk 0.1.0a5__tar.gz → 0.1.0a7__tar.gz

matelab_python_sdk-0.1.0a7/.env.example

@@ -0,0 +1,14 @@
+# SDK Provider smoke must target the confirmed isolated test service.
+# Authentication and external-token refresh persist Provider token state.
+# Keep these names aligned with matelab-spec Provider Verification.
+MATELAB_PROVIDER_BASE_URL=
+MATELAB_PROVIDER_USERNAME=
+MATELAB_PROVIDER_PASSWORD=
+
+# The SDK smoke does not read the settings below. Populate them only when the
+# same .env.test will also run the complete matelab-spec Provider Verification.
+MATELAB_PROVIDER_SHARE_USER_ID=
+MATELAB_PROVIDER_SECONDARY_USERNAME=
+MATELAB_PROVIDER_SECONDARY_PASSWORD=
+MATELAB_PROVIDER_RECORD_STAGING_MUTATIONS=
+MATELAB_PROVIDER_CHAT_SSO_KEY=

{matelab_python_sdk-0.1.0a5 → matelab_python_sdk-0.1.0a7}/AGENTS.md

@@ -1,8 +1,8 @@
 # AGENTS.md
 
 本文档只保留维护 `matelab-python-sdk` 必须长期遵守的项目约束。当前能力和使用方式见
-`README.md`，实现路线与进度见 `docs/roadmap.md`，operation 状态以
-`docs/operation-coverage.yaml` 为机器权威。不要在本文记录阶段性完成状态、一次性验收数字或迁移历史。
+`README.md`，版本历史见 `CHANGELOG.md`，operation 状态以 `docs/operation-coverage.yaml` 为机器权威。
+不要在本文记录阶段性完成状态、一次性验收数字或迁移历史。
 
 ## 权威与范围
 
@@ -50,8 +50,11 @@
 - `base_url` 表示 Provider API 根。query、JSON、form-urlencoded、multipart 和 streaming 必须按各 operation
   定义分别实现。
 - bearer 只用于要求认证的 operation；成功码按 operation 配置，不能全局接受 `{0, 10}`。
-- 每个 `AsyncMatelab` 实例最多持有一个进程内 Session，包含 access/refresh token、毫秒 expiration 和可选
-  identity；不同用户的 token pair 必须拒绝绑定，失败时不得替换现有 Session。
+- 每个 `AsyncMatelab` 实例最多持有一个进程内 Session，包含 access/refresh token、毫秒 expiration 和已验证
+  identity。SDK 不提供裸 access/refresh token 绑定接口；构造传入完整 Session 的真实性和身份归属验证属于
+  集成方。
+- `Token`、`Identity` 和 `Session` 是冻结、拒绝额外字段的 Pydantic public model，组成稳定的规范化 Session
+  JSON 契约。token 在 repr 中隐藏，但显式序列化必须保留真实凭证；序列化结果不得进入日志或发送给不可信方。
 - `client.session` 暴露实例内最新 Session。持久化、加密、撤销、`userid/session_id` 关联和跨进程锁属于
   集成方；不同逻辑 Session 不得共享同一个 `AsyncMatelab`，但多个实例可以共享注入的 `httpx.AsyncClient`。
 - access 到期前按 skew 刷新；并发刷新使用单个异步锁；已认证且可安全重试的请求遇到 `code=5` 最多强制

{matelab_python_sdk-0.1.0a5 → matelab_python_sdk-0.1.0a7}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.0a7 - 2026-08-04
+
+- Replaces the hand-maintained wire-validation rule tables with deterministic generated JSON Schema 2020-12 rules.
+- Simplifies transport, streaming, error mapping, and domain adapters while retaining the pinned `matelab-spec v0.3.0`
+  behavior and automatic Session refresh guarantees.
+- Breaking: tightens several public domain inputs and results, and exposes stable `MatelabProviderErrorKind` values
+  instead of raw Provider error codes.
+- Removes completed roadmap and work-package bookkeeping; refreshes release checks, documentation, and tests.
+
+## 0.1.0a6 - 2026-08-01
+
+- Adopts the immutable `matelab-spec v0.3.0` Contract release and its form-encoding updates.
+- Tightens the public authentication/session contract around complete, serializable Pydantic `Session` models while
+  retaining automatic access-token refresh and Provider SSO exchange.
+- Simplifies transport and domain interfaces, removes external-token binding and identity-attachment seams, and
+  restores strict runtime validation for byte-range inputs.
+
 ## 0.1.0a5 - 2026-07-29
 
 - Adopts immutable `matelab-spec v0.1.2` at commit `6dd674ac001ae61197495ace5eba489d585cb825` and OpenAPI