v0.1.11

变更摘要

• 新增: CollabAgentService 用于子 agent 生命周期管理
• 新增: ExecSessionService 和 ProcessReaper 支持进程清理
• 新增: SourceClientRegistry 提取连接生命周期管理
• 修复: RPC liveness 健壮性增强
• 重构: RuntimeServer 服务组合简化
• 重构: 去重 exec registry IO，修复 client registry 封装

v0.1.10

• Improved package metadata with an English PyPI summary.
• Stabilized waiting-human and host-resume behavior for human-in-the-loop runtime flows.
• Added ToolRegistry descriptor API alignment and related guardrails.
• Refined examples, Studio guidance, and downstream runtime readiness checks.

v0.1.9.post1

修复发布

Changes

• SDK 代码质量改进
• Studio MVP 迁移至 examples/
• 更新 versioning 测试

Full Changelog: v0.1.9...v0.1.9.post1

v0.1.8

v0.1.8

• Safety hardening and stricter runtime bounds
• Docs: clarified Studio integration endpoints (cookbook/troubleshooting)
• Examples: clarified gateway vs Studio API boundaries

v0.1.7

变更摘要

• 核心运行时重构：Agent thin facade + AgentLoop，并引入 SafetyGate / ToolSafetyDescriptor，使工具安全与审批边界更清晰。
• 修复 sandbox.profile 预设覆盖语义：profile preset 仅补齐缺省值，用户显式配置优先（不再被 preset 覆盖）。
• Python 包版本更新至 0.1.7（与 git tag v0.1.7 对齐）。

v0.1.6

v0.1.6（相对 v0.1.5.post1）

Highlights

• 事件/WAL 可观测性增强：skill_injected 事件 payload 补齐稳定标识字段（namespace / skill_locator / space_id / source_id），便于 UI/consumer 做归因与 drill-down。
• Skills Bundles（Redis ZIP）：新增 Redis ZIP bundles 形态，支持 actions / skill_ref_read 的打包分发与更强的安全约束（配套 tests 与 perf eval）。
• 安全与审批口径对齐：shell wrappers 与 approvals 脱敏口径对齐，减少绕过与审计漂移。

Changes

Features

• Skills：Redis zip bundles for actions / references。
• Events：skill_injected payload 新增稳定标识字段（向后兼容）。

Tests

• 补齐 Redis bundles 的安全/审批/性能覆盖用例。
• 新增 skill_injected 新字段与 JSON-serializable 的回归护栏测试。

Docs / Help

• 新增/扩展多篇 help 文档（架构内部细节、unattended approvals 指南、namespace mentions 最佳实践、skills storage 指南等）。

Compatibility Notes

• skill_injected 仅 新增字段，不改变既有字段与事件类型；旧 consumer 可忽略新增键。

v0.1.5

破坏性变更（Breaking）

• Skills mention 语法升级为：$[<namespace>].<skill_name>
  • namespace：1..7 段有序 segment，使用 : 分隔（顺序敏感）
  • segment：小写字母/数字/中划线；首尾字母/数字；长度 2..64
• Skills space 配置升级为：skills.spaces[].namespace，并 fail-fast 拒绝 legacy account/domain

迁移要点

• 旧：$[account:domain].skill_name → 新：$[namespace].skill_name
• 旧：
  • skills.spaces[].account
  • skills.spaces[].domain
    新：
  • skills.spaces[].namespace: "a:b:c"

文档与示例

• 新增 Help 专题：help/13-namespace-mentions.cn.md（英文：help/13-namespace-mentions.md）
• README / examples / docs_for_coding_agent 全量对齐新语法

v0.1.4.post2

• BREAKING: Python import 名从 agent_sdk 改为 skills_runtime（不兼容旧入口，agent_sdk 为 tombstone 直接报错）\n- pip 发行名保持 skills-runtime-sdk\n- 全仓 docs/help/examples/Studio MVP 与 SDK 同步对齐\n\n升级方式：\n- pip install -U skills-runtime-sdk\n- 代码改为：from skills_runtime.agent import Agent\n

v0.1.4.post1

Highlights

• Python SDK: skills 配置全面切到显式 schema（spaces/sources/scan/injection/actions/references），移除旧兼容路径。
• Python SDK: OpenAI Chat streaming 仅保留 ChatRequest 契约入口，删除 legacy stream_chat(model, messages, ...) 兼容 API。
• Python SDK: Coordinator 子 agent 结果增加 events_path 兼容字段（与 wal_locator 并存）。
• Studio: sources API 对齐并移除 legacy approvals 格式。
• Tests/Docs/Examples: 增加严格契约护栏，并同步示例与文档到 breaking 变更后的新契约。

Changelog

• chore(release): v0.2.0
• refactor(studio): align sources API and remove legacy approvals format
• test(python): add strict validation and contract guardrails
• refactor(python): remove legacy compat and tighten contracts
• examples: align wal_locator and studio sources contract
• docs: align help and guides with breaking compat removal
• fix(python): add events_path alias for ChildResult
• refactor(python): explicit skills schema + drop legacy chat API

v0.1.4

v0.1.4

本版本是一次 patch 版本发布（v0.1.3 → v0.1.4），用于对外发布“生产级重构（P0）初步完成”的能力集合（主要实现落在 tag：refactor-p0-initial）。

亮点（P0 初步完成）

• WAL 后端抽象 + 可注入：新增 WalBackend 协议与 InMemoryWal，Agent 支持注入非文件 WAL。
• 终态 wal_locator 契约：run_completed/run_failed/run_cancelled 终态 payload 提供 wal_locator（并兼容写入 events_path 作为 locator 语义），用于日志关联与取证定位。
• 单一确定性事件管线：统一事件出口顺序为 WAL append → hooks → stream，并确保 tool 侧“旁路事件”可被 hooks/stream 观察且 WAL 不重复。
• LLM v2 调用通道：引入 ChatRequest 参数包与 stream_chat_v2；Agent loop 内部以 v2 为主路径，v1-only backend 通过 shim 继续可用。
• 结构化运行错误（typed run errors）：RunErrorKind/RunError 作为稳定、机器可消费的 run_failed payload 口径；补齐 missing_env_var 分类，避免集成方依赖 message 字符串解析。
• 审批与无人值守构造：新增 RuleBasedApprovalProvider（默认 fail-closed），并提供 AgentBuilder 统一构造入口与 cloud_unattended_preset（便于云端无人值守集成）。
• OpenAI backend 重试/退避硬化：补齐 429/5xx 重试、Retry-After 解析、指数退避 + jitter、max_retries 强制；并满足“emitted_any 后不重试”的保守语义。
• skills sources 生产硬化：pgsql/redis sources 支持生产级注入策略（factory/pool、可替换 client），避免默认单例连接的并发风险。

兼容性与迁移提示

• 建议优先使用 AgentBuilder 构造 Agent，避免集成方遗漏关键依赖项；并用 preset 快速进入无人值守形态。
• LLM backend 接口：推荐实现 stream_chat_v2(ChatRequest)；旧 stream_chat 仍可通过 shim 兼容，但建议逐步迁移。
• WAL 字段语义：如你在下游读取 events_path，请将其视为“定位符（locator）”，并优先使用 wal_locator。
• 配置与 API 的最新可运行示例以 help/ 为准（尤其是：help/02-config-reference.*、help/03-sdk-python-api.*、help/06-tools-and-safety.*）。

验证（可复现）

• 离线单测回归：bash scripts/pytest.sh
• Tier-0 确定性门禁：bash scripts/tier0.sh

参考

• 重构初步完成标签：refactor-p0-initial