agentledger-runtime 1.3.2__tar.gz → 1.3.3__tar.gz

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/CHANGELOG.md

@@ -8,6 +8,17 @@ This project follows semantic versioning for the stable runtime-core contract. O
 
 No unreleased changes yet.
 
+## 1.3.3
+
+### Added
+
+- Added stable Inspector read-model anchors and related links for timeline events, steps, Tool Ledger rows, approval requests, policy decisions, and artifacts.
+- Added static HTML report navigation and internal cross-links so local reports can jump between events, tools, approvals, and artifacts without running a server.
+
+### Clarified
+
+- This is an Inspector-only patch release. It does not change the stable runtime-core contract or require Go, TypeScript, or Rust runtime-core changes.
+
 ## 1.3.2
 
 ### Added

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentledger-runtime
-Version: 1.3.2
+Version: 1.3.3
 Summary: Runtime reliability layer for Agent Harness stacks
 Project-URL: Homepage, https://github.com/yaogdu/AgentLedger
 Project-URL: Repository, https://github.com/yaogdu/AgentLedger
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
 Provides-Extra: all
-Requires-Dist: agentledger-inspector<2,>=1.3.2; extra == 'all'
+Requires-Dist: agentledger-inspector<2,>=1.3.3; extra == 'all'
 Requires-Dist: agentledger-langfuse<2,>=1.3; extra == 'all'
 Requires-Dist: agentledger-langgraph<2,>=1.3; extra == 'all'
 Requires-Dist: agentledger-mcp<2,>=1.3; extra == 'all'
@@ -33,7 +33,7 @@ Requires-Dist: agentledger-sandbox-docker<2,>=1.3; extra == 'all'
 Provides-Extra: docker
 Requires-Dist: agentledger-sandbox-docker<2,>=1.3; extra == 'docker'
 Provides-Extra: inspector
-Requires-Dist: agentledger-inspector<2,>=1.3.2; extra == 'inspector'
+Requires-Dist: agentledger-inspector<2,>=1.3.3; extra == 'inspector'
 Provides-Extra: langfuse
 Requires-Dist: agentledger-langfuse<2,>=1.3; extra == 'langfuse'
 Provides-Extra: langgraph
@@ -333,7 +333,7 @@ AgentLedger is also not a new LLM SDK, not a workflow engine, not a general obse
 
 ## Current maturity
 
-AgentLedger 1.3.x is a stable runtime-core line with Python as the reference implementation and Go, TypeScript, and Rust covered by shared runtime-core parity gates. The current Python/Inspector patch is 1.3.2; Go, TypeScript, and Rust runtime-core package baselines remain 1.3.1 until their next runtime-core release. It is suitable for local use, framework adapter integration, reliability semantics validation, and production pilot preparation with explicit adapter boundaries.
+AgentLedger 1.3.x is a stable runtime-core line with Python as the reference implementation and Go, TypeScript, and Rust covered by shared runtime-core parity gates. The current Python/Inspector patch is 1.3.3; Go, TypeScript, and Rust runtime-core package baselines remain 1.3.1 until their next runtime-core release. It is suitable for local use, framework adapter integration, reliability semantics validation, and production pilot preparation with explicit adapter boundaries.
 
 The runtime-core contract is stable; optional production adapters and external infrastructure hardening remain separately tracked. See [docs/MATURITY_MODEL.md](docs/MATURITY_MODEL.md), [docs/IMPLEMENTATION_STATUS.md](docs/IMPLEMENTATION_STATUS.md), and [docs/ROADMAP.md](docs/ROADMAP.md).
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/README.md

@@ -281,7 +281,7 @@ AgentLedger is also not a new LLM SDK, not a workflow engine, not a general obse
 
 ## Current maturity
 
-AgentLedger 1.3.x is a stable runtime-core line with Python as the reference implementation and Go, TypeScript, and Rust covered by shared runtime-core parity gates. The current Python/Inspector patch is 1.3.2; Go, TypeScript, and Rust runtime-core package baselines remain 1.3.1 until their next runtime-core release. It is suitable for local use, framework adapter integration, reliability semantics validation, and production pilot preparation with explicit adapter boundaries.
+AgentLedger 1.3.x is a stable runtime-core line with Python as the reference implementation and Go, TypeScript, and Rust covered by shared runtime-core parity gates. The current Python/Inspector patch is 1.3.3; Go, TypeScript, and Rust runtime-core package baselines remain 1.3.1 until their next runtime-core release. It is suitable for local use, framework adapter integration, reliability semantics validation, and production pilot preparation with explicit adapter boundaries.
 
 The runtime-core contract is stable; optional production adapters and external infrastructure hardening remain separately tracked. See [docs/MATURITY_MODEL.md](docs/MATURITY_MODEL.md), [docs/IMPLEMENTATION_STATUS.md](docs/IMPLEMENTATION_STATUS.md), and [docs/ROADMAP.md](docs/ROADMAP.md).
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/README.zh-CN.md

@@ -282,7 +282,7 @@ AgentLedger 也不是新的 LLM SDK，不是 workflow engine，不是通用 obse
 
 ## 当前成熟度
 
-AgentLedger 1.3.x 是 stable runtime-core line，Python 是 reference implementation，Go、TypeScript、Rust 已由共享 runtime-core parity gate 覆盖。当前 Python/Inspector patch 是 1.3.2；Go、TypeScript、Rust runtime-core package baseline 仍是 1.3.1，直到它们进入下一次 runtime-core release。适合本地使用、framework adapter integration、reliability semantics 验证，以及在明确 adapter 边界下做 production pilot 准备。
+AgentLedger 1.3.x 是 stable runtime-core line，Python 是 reference implementation，Go、TypeScript、Rust 已由共享 runtime-core parity gate 覆盖。当前 Python/Inspector patch 是 1.3.3；Go、TypeScript、Rust runtime-core package baseline 仍是 1.3.1，直到它们进入下一次 runtime-core release。适合本地使用、framework adapter integration、reliability semantics 验证，以及在明确 adapter 边界下做 production pilot 准备。
 
 runtime-core contract 已稳定；optional production adapter 和外部基础设施加固仍按独立阶段推进。详见 [docs/MATURITY_MODEL.md](docs/MATURITY_MODEL.md)、[docs/zh/IMPLEMENTATION_STATUS.md](docs/zh/IMPLEMENTATION_STATUS.md) 和 [docs/zh/ROADMAP.md](docs/zh/ROADMAP.md)。
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/COMPLETE_CORE_PARITY_CHECKLIST.md

@@ -56,7 +56,7 @@ Excluded or not applicable:
 | Quickstart docs | Language quickstart and adapter quickstart | README + docs | `go/README.md` | `typescript/README.md` | `rust/README.md` | docs link check | done |
 | Examples | Runnable examples for core runtime and adapter API | Python examples | `go/examples/quickstart/main.go` | `typescript/examples/quickstart/quickstart.js` | `rust/examples/quickstart.rs` | `scripts/check_complete_core_parity.py` | done |
 | Package metadata | Installable package metadata in the current 1.3 release family | PyPI metadata `1.3.x` | `go.mod` tag `go/v1.3.1` for current baseline | npm package `1.3.1` for current baseline | `Cargo.toml` `1.3.1` for current baseline | `scripts/check_complete_core_parity.py` release-family check | done |
-| Package install smoke | Install/import/run from published or built package | PyPI `agentledger-runtime==1.3.2` release smoke after publish for current Inspector patch | `go/v1.3.1` clean external `go get` smoke after tag | npm `agentledger-runtime@1.3.1` release smoke after publish | crates.io `agentledger-runtime==1.3.1` release smoke after publish | publish logs + `scripts/check_complete_core_parity.py` dry-run gates | release-gated |
+| Package install smoke | Install/import/run from published or built package | PyPI `agentledger-runtime==1.3.3` release smoke after publish for current Inspector patch | `go/v1.3.1` clean external `go get` smoke after tag | npm `agentledger-runtime@1.3.1` release smoke after publish | crates.io `agentledger-runtime==1.3.1` release smoke after publish | publish logs + `scripts/check_complete_core_parity.py` dry-run gates | release-gated |
 | Release docs | Changelog, release checklist, status docs reflect exact parity boundary | docs | docs | docs | docs | docs link check | done |
 | Comparison docs | Honest overlap with LangChain/LangGraph/LangSmith/Langfuse/etc. | docs | docs | docs | docs | docs link check | done |
 
@@ -67,7 +67,7 @@ The strict core parity gate now covers the previously weak areas:
 1. CLI baseline is automatically checked for all four language CLIs.
 2. Go, TypeScript, and Rust have runnable quickstart example files.
 3. TypeScript and Rust package surfaces have package dry-run checks (`npm pack --dry-run`, `cargo package --allow-dirty --no-verify`) and post-publish install smokes are required for release.
-4. Package release families are checked across Python, TypeScript, and Rust. The current core release family is `1.3`; Python may carry Inspector-only patch releases such as `1.3.2` without changing non-Python runtime-core baselines.
+4. Package release families are checked across Python, TypeScript, and Rust. The current core release family is `1.3`; Python may carry Inspector-only patch releases such as `1.3.3` without changing non-Python runtime-core baselines.
 5. Go external module consumption is tag/release dependent; each release should repeat the clean external `go get` smoke after pushing the `go/vX.Y.Z` tag.
 6. Real service-backed hardening remains out of scope for core parity and stays documented as optional follow-up work.
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/IMPLEMENTATION_STATUS.md

@@ -15,7 +15,7 @@ AgentLedger 1.3.x is a stable runtime-core line with Python as the reference imp
 - reliability semantics validation
 - production pilot preparation with explicit adapter boundaries
 
-Release-scope note: 1.3.0 added Inspector as a read-only evidence/runtime metadata consumer. It can read exported evidence bundles or connect to SQLite/Postgres/MySQL AgentLedger metadata with read-only credentials and can export a static HTML debug report. 1.3.2 adds configurable redaction for Inspector JSON/HTML output. MySQL remains the 1.2.2 storage adapter boundary and Langfuse remains the 1.2.3 observability adapter boundary; real-service production claims still require external validation.
+Release-scope note: 1.3.0 added Inspector as a read-only evidence/runtime metadata consumer. It can read exported evidence bundles or connect to SQLite/Postgres/MySQL AgentLedger metadata with read-only credentials and can export a static HTML debug report. 1.3.2 adds configurable redaction for Inspector JSON/HTML output. 1.3.3 adds static report navigation and read-model cross-links for timeline, tool, approval, policy, and artifact records. MySQL remains the 1.2.2 storage adapter boundary and Langfuse remains the 1.2.3 observability adapter boundary; real-service production claims still require external validation.
 
 The runtime-core contract is stable. Optional production adapters, external infrastructure hardening, and full eval systems remain outside the stable core boundary; non-Python runtime-core baselines are verified by the shared parity gates.
 
@@ -58,7 +58,7 @@ Excluded from this boundary:
 | Adapter contracts | framework adapter base, LangGraph facade, MCP tool/context mapping, dependency-free method facades, first-party adapter package boundaries |
 | Sandbox boundary | fail-closed `none`, local executor, router, external executor contracts, Docker/bubblewrap command paths, Kubernetes dry-run/gated path |
 | Observability | trace JSONL export with media/stream spans, dependency-free OTLP JSON export, optional OTLP/JSON collector POST, evidence-linked audit records |
-| Inspector | `agentledger.inspector.v1` read model, `agentledger inspector run/evidence`, static HTML report, evidence-bundle input, read-only SQLite input, Postgres/MySQL read paths through existing adapter boundaries, configurable redaction policy, optional `agentledger-inspector` companion package |
+| Inspector | `agentledger.inspector.v1` read model, `agentledger inspector run/evidence`, static HTML report, section navigation, row anchors, cross-links between related records, evidence-bundle input, read-only SQLite input, Postgres/MySQL read paths through existing adapter boundaries, configurable redaction policy, optional `agentledger-inspector` companion package |
 | Reliability checks | failure injection suite, failure attribution report, conformance runners including media runtime conformance, runtime-boundary lint, scheduler facade, adversarial review, evidence regression for shell, HTTP, cloud, GitHub, and common model SDK bypasses with JSON rule-pack extension |
 | Media and stream contracts | `MediaArtifact`, `MediaMetadata`, `ArtifactLineage`, `StreamChunkRef`, `EventStreamCheckpoint`, `AgentContext.create_media_artifact(...)`, `AgentContext.create_stream_checkpoint(...)`, media/stream tool schema conventions, ToolGateway/Tool Ledger media tool example, evidence indexes, replay artifact validation/counts |
 | Release scaffolding | CI workflow, changelog, security policy, versioning policy, release checklist, contributor checks, bilingual documentation entrypoints, SVG architecture diagram, ResourceWarning-sensitive test gate, adapter certification checklist, adapter packaging docs/checks |
@@ -77,7 +77,7 @@ Excluded from this boundary:
 | MCP support | descriptor-to-ToolSpec mapping, dependency-free tool/context server fixtures, context read tool adapter, examples, `agentledger-mcp` package boundary | exact MCP SDK client/server integration |
 | Sandbox | contract, local/fail-closed modes, command-style Docker/bubblewrap, Kubernetes dry-run/gated execution, E2B/Firecracker slots, Docker sandbox package boundary | hardened isolation packages, secret injection policy, network policy recipes, resource limit validation |
 | Retention and backup checks | non-destructive retention plan with media/stream protected refs, compaction marker, and backup readiness check including media/stream nested refs | actual compaction/snapshot job that preserves replay guarantees |
-| Time travel and debug | JSON CLI timeline, state reconstruction, state diff view, `debug --json`, `--include-diffs`, `--include-states`, optional static HTML report export, Inspector static report | richer report layout and artifact cross-links; no long-running web app in core |
+| Time travel and debug | JSON CLI timeline, state reconstruction, state diff view, `debug --json`, `--include-diffs`, `--include-states`, optional static HTML report export, Inspector static report with local navigation and cross-links | richer report layout and remote artifact browser; no long-running web app in core |
 
 ## Remaining Gaps And Preview Areas
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/INSPECTOR.md

@@ -90,6 +90,22 @@ The `--blob-root` argument currently points at a local blob directory containing
 
 `--html` writes a static HTML report for local or internal debugging. The file is self-contained and can be opened without a server.
 
+## Navigation And Cross-links
+
+`1.3.3` adds stable row anchors and related links to the Inspector read model. Timeline events, steps, Tool Ledger rows, approval requests, policy decisions, and artifacts may include:
+
+```json
+{
+  "anchor": "event-1",
+  "related_refs": [{"kind": "tool", "value": "email.send"}],
+  "related_links": [{"kind": "tool", "value": "email.send", "href": "#tool-email-send"}]
+}
+```
+
+The default static HTML renderer uses those fields for a top-level section navigation bar and internal links between events, tools, approvals, and artifacts. Custom viewers can consume the same fields from `InspectorReport.to_dict()` and do not need to inspect database tables directly.
+
+These links are local report navigation only. They do not fetch blobs, call tools, mutate runtime state, approve requests, or access remote artifact stores.
+
 ## Redaction
 
 Inspector output can include sensitive operational evidence, especially when `--include-payloads` is used. `1.3.2` adds explicit redaction for JSON and HTML reports. Redaction is applied to the Inspector read model before rendering, so custom viewers that consume `InspectorReport.to_dict()` receive the same masked data as the default HTML renderer.
@@ -199,6 +215,11 @@ Implemented in `1.3.2`:
 
 - configurable JSON/HTML report redaction through `--redact-key`, `--redaction-policy`, and `InspectorRedactionPolicy`
 
+Implemented in `1.3.3`:
+
+- stable read-model anchors for timeline, step, Tool Ledger, approval, policy, and artifact rows
+- static HTML section navigation and internal cross-links between related runtime records
+
 Not in this version:
 
 - long-running web server

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/LANGUAGE_QUICKSTART.md

@@ -2,7 +2,7 @@
 
 [English](LANGUAGE_QUICKSTART.md) | [中文](zh/LANGUAGE_QUICKSTART.md)
 
-AgentLedger 1.3.x has one Python reference runtime and native preview runtime-core baselines for Go, TypeScript, and Rust. The shared promise is semantic parity for runtime-core: durable runs, leases, Tool Ledger, evidence, replay, policy/approval/sandbox boundaries, cost/failure attribution, conformance, and official optional adapter contracts. Python may carry Inspector-only patch releases such as 1.3.2 while the non-Python runtime-core package baselines remain on the latest shared runtime-core tag.
+AgentLedger 1.3.x has one Python reference runtime and native preview runtime-core baselines for Go, TypeScript, and Rust. The shared promise is semantic parity for runtime-core: durable runs, leases, Tool Ledger, evidence, replay, policy/approval/sandbox boundaries, cost/failure attribution, conformance, and official optional adapter contracts. Python may carry Inspector-only patch releases such as 1.3.3 while the non-Python runtime-core package baselines remain on the latest shared runtime-core tag.
 
 The non-Python packages are native runtime packages, not thin clients: each runs a native local runtime loop and reports the shared conformance checks.
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/ROADMAP.md

@@ -212,8 +212,6 @@ Explicitly not in this version:
 
 Follow-up work:
 
-- richer report navigation and artifact cross-links
-- configurable redaction policies
 - evidence-driven replay/regression lab over Inspector read models
 - optional local/internal web viewer if it remains read-only and dependency-isolated
 
@@ -561,6 +559,11 @@ Implemented in `1.3.2`:
 - CLI support for `--redact-key`, `--redaction-policy`, and `--redaction-replacement`
 - `InspectorRedactionPolicy` API for custom read-model consumers
 
+Implemented in `1.3.3`:
+
+- stable read-model anchors for timeline, step, Tool Ledger, approval, policy, and artifact rows
+- static HTML section navigation and internal cross-links between related runtime records
+
 Follow-up work:
 
 - run/session list with status, timestamps, cost summary, and failure summary

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/zh/COMPLETE_CORE_PARITY_CHECKLIST.md

@@ -26,7 +26,7 @@
 1. 四语言 CLI baseline 已有自动化检查，不再只依赖 conformance。
 2. Go、TypeScript、Rust 已有 runnable quickstart example files。
 3. TypeScript/Rust package surface 已有 `npm pack --dry-run` / `cargo package --allow-dirty --no-verify` 发布 dry-run；发布后仍需重复 clean install smoke。
-4. Python、TypeScript、Rust 的 package release family 已自动检查；当前 core release family 是 `1.3`。Python 可以有 Inspector-only patch release，例如 `1.3.2`，不代表非 Python runtime-core baseline 必须同时变化。
+4. Python、TypeScript、Rust 的 package release family 已自动检查；当前 core release family 是 `1.3`。Python 可以有 Inspector-only patch release，例如 `1.3.3`，不代表非 Python runtime-core baseline 必须同时变化。
 5. Go module 外部消费依赖 Git tag/release；每次 release 推送 `go/vX.Y.Z` tag 后都需要重复 clean external `go get` smoke。
 6. 真实服务 hardening 仍不属于 core parity，继续作为 optional follow-up 记录。
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/zh/IMPLEMENTATION_STATUS.md

@@ -15,7 +15,7 @@ AgentLedger 1.3.x 是 stable runtime-core line，Python 是 reference implementa
 - reliability semantics 验证
 - 在明确 adapter 边界下做 production pilot 准备
 
-版本范围说明：1.3.0 增加 Inspector，定位是只读 evidence/runtime metadata consumer。它可以读取导出的 evidence bundle，也可以用只读凭证连接 SQLite/Postgres/MySQL AgentLedger metadata，并导出静态 HTML debug report。1.3.2 增加 Inspector JSON/HTML 输出的可配置脱敏。MySQL 仍是 1.2.2 的 storage adapter boundary，Langfuse 仍是 1.2.3 的 observability adapter boundary；真实服务生产级声明仍需要外部验证。
+版本范围说明：1.3.0 增加 Inspector，定位是只读 evidence/runtime metadata consumer。它可以读取导出的 evidence bundle，也可以用只读凭证连接 SQLite/Postgres/MySQL AgentLedger metadata，并导出静态 HTML debug report。1.3.2 增加 Inspector JSON/HTML 输出的可配置脱敏。1.3.3 增加 static report navigation，以及 timeline、tool、approval、policy、artifact record 的 read-model cross-links。MySQL 仍是 1.2.2 的 storage adapter boundary，Langfuse 仍是 1.2.3 的 observability adapter boundary；真实服务生产级声明仍需要外部验证。
 
 runtime-core contract 已稳定。optional production adapter、外部基础设施加固和完整 eval 系统都不属于 stable core 边界；非 Python runtime-core baseline 由共享 parity gate 验证。
 
@@ -58,7 +58,7 @@ runtime-core contract 已稳定。optional production adapter、外部基础设
 | Adapter contract | framework adapter base、LangGraph facade、MCP tool/context mapping、dependency-free method facades、第一方 adapter package boundaries |
 | Sandbox boundary | fail-closed `none`、local executor、router、external executor contract、Docker/bubblewrap command path、Kubernetes dry-run/gated path |
 | Observability | trace JSONL export、dependency-free OTLP JSON export、optional OTLP/JSON collector POST、evidence-linked audit record |
-| Inspector | `agentledger.inspector.v1` read model、`agentledger inspector run/evidence`、静态 HTML report、evidence-bundle input、read-only SQLite input、通过已有 adapter boundary 的 Postgres/MySQL read path、可配置 redaction policy、optional `agentledger-inspector` companion package |
+| Inspector | `agentledger.inspector.v1` read model、`agentledger inspector run/evidence`、静态 HTML report、section navigation、row anchor、相关 record 之间的 cross-link、evidence-bundle input、read-only SQLite input、通过已有 adapter boundary 的 Postgres/MySQL read path、可配置 redaction policy、optional `agentledger-inspector` companion package |
 | Reliability checks | failure injection suite、failure attribution report、conformance runner、runtime-boundary lint, scheduler facade, adversarial review, evidence regression、JSON rule-pack extension |
 | Media/stream contracts | `MediaArtifact`、`MediaMetadata`、`ArtifactLineage`、`StreamChunkRef`、`EventStreamCheckpoint`、AgentContext helpers、tool schema conventions、evidence/replay validation |
 | 开源发布骨架 | CI workflow、changelog、security policy、versioning policy、release checklist、contributor checks、中英文文档入口、SVG 架构图、adapter certification checklist、adapter packaging docs/checks |
@@ -79,7 +79,7 @@ runtime-core contract 已稳定。optional production adapter、外部基础设
 | MCP support | descriptor-to-ToolSpec mapping、dependency-free tool/context fixtures、context read tool adapter、examples、`agentledger-mcp` package boundary | exact MCP SDK client/server integration |
 | Sandbox | contract、local/fail-closed modes、Docker/bubblewrap command-style path、Kubernetes dry-run/gated execution、E2B/Firecracker slots、Docker sandbox package boundary | hardened isolation packages、secret injection policy、network policy recipe、resource limit validation |
 | Retention/backup checks | non-destructive retention plan、compaction marker、backup readiness check | 保留 replay guarantees 的实际 compaction/snapshot job |
-| Time travel/debug | JSON CLI timeline、state reconstruction、state diff、`debug --json`、`--include-diffs`、`--include-states`、static HTML export、Inspector static report | 更丰富 report layout 和 artifact cross-links；core 不做长运行 Web 应用 |
+| Time travel/debug | JSON CLI timeline、state reconstruction、state diff、`debug --json`、`--include-diffs`、`--include-states`、static HTML export、带本地导航和 cross-link 的 Inspector static report | 更丰富 report layout 和 remote artifact browser；core 不做长运行 Web 应用 |
 
 ## 剩余缺口与 Preview 区域
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/zh/INSPECTOR.md

@@ -90,6 +90,22 @@ Postgres/MySQL 建议使用只读数据库账号。AgentLedger 不为 Inspector
 
 `--html` 写出静态 HTML 报告，适合本地或内网排查问题；打开 HTML 不需要启动服务。
 
+## 导航和交叉链接
+
+`1.3.3` 在 Inspector read model 中增加了稳定的行级 anchor 和 related links。Timeline event、step、Tool Ledger row、approval request、policy decision 和 artifact 可能包含：
+
+```json
+{
+  "anchor": "event-1",
+  "related_refs": [{"kind": "tool", "value": "email.send"}],
+  "related_links": [{"kind": "tool", "value": "email.send", "href": "#tool-email-send"}]
+}
+```
+
+默认静态 HTML renderer 会用这些字段生成顶部 section 导航，以及 event、tool、approval、artifact 之间的内部跳转。二开的 viewer 可以直接消费 `InspectorReport.to_dict()` 中的这些字段，不需要读取未文档化的数据库表。
+
+这些链接只用于本地 report 导航。它们不会拉取 blob、调用工具、修改 runtime state、approve request，也不会访问远程 artifact store。
+
 ## 脱敏
 
 Inspector 输出可能包含敏感运行证据，尤其是在使用 `--include-payloads` 时。`1.3.2` 增加了显式 redaction policy，作用于 JSON read model 和 HTML report。脱敏会在渲染前作用到 Inspector read model，所以二开的 viewer 如果消费 `InspectorReport.to_dict()`，拿到的也是同一份脱敏后的数据。
@@ -199,6 +215,11 @@ data = report.to_dict()
 
 - 通过 `--redact-key`、`--redaction-policy` 和 `InspectorRedactionPolicy` 对 JSON/HTML report 做可配置脱敏
 
+`1.3.3` 已实现：
+
+- timeline、step、Tool Ledger、approval、policy 和 artifact row 的稳定 read-model anchor
+- static HTML section navigation，以及相关 runtime record 之间的内部交叉链接
+
 本版本不包含：
 
 - 长运行 Web server

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/zh/LANGUAGE_QUICKSTART.md

@@ -2,7 +2,7 @@
 
 [English](../LANGUAGE_QUICKSTART.md) | [中文](LANGUAGE_QUICKSTART.md)
 
-AgentLedger 1.3.x 包含 Python reference runtime，以及 Go、TypeScript、Rust 的 native preview runtime-core baseline。共享承诺是 runtime-core 语义对齐：durable run、lease、Tool Ledger、evidence、replay、policy/approval/sandbox boundary、cost/failure attribution、conformance 和 official optional adapter contract。Python 可以有 Inspector-only patch release，例如 1.3.2；非 Python runtime-core package baseline 仍保持在最近一次共享 runtime-core tag。
+AgentLedger 1.3.x 包含 Python reference runtime，以及 Go、TypeScript、Rust 的 native preview runtime-core baseline。共享承诺是 runtime-core 语义对齐：durable run、lease、Tool Ledger、evidence、replay、policy/approval/sandbox boundary、cost/failure attribution、conformance 和 official optional adapter contract。Python 可以有 Inspector-only patch release，例如 1.3.3；非 Python runtime-core package baseline 仍保持在最近一次共享 runtime-core tag。
 
 非 Python package 是 native runtime package，不是 thin client：它们都能运行本地 native runtime loop，并报告共享 conformance checks。
 

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/docs/zh/ROADMAP.md

@@ -210,8 +210,6 @@ adoption 目标不是直接追 star，而是让项目在几分钟内可理解、
 
 后续工作：
 
-- 更丰富 report navigation 和 artifact cross-link
-- configurable redaction policy
 - 基于 Inspector read model 的 evidence-driven replay/regression lab
 - 如果保持 read-only 且依赖隔离，再考虑 optional local/internal web viewer
 
@@ -598,6 +596,13 @@ CLI 支持 --redact-key、--redaction-policy 和 --redaction-replacement
 给自定义 read-model consumer 使用的 InspectorRedactionPolicy API
 ```
 
+`1.3.3` 已实现：
+
+```text
+timeline、step、Tool Ledger、approval、policy、artifact row 的稳定 read-model anchor
+相关 runtime record 之间的 static HTML section navigation 和内部 cross-link
+```
+
 后续工作：
 
 ```text

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/packages/agentledger-inspector/README.md

@@ -53,6 +53,8 @@ agentledger inspector run <run_id> --backend mysql --dsn "$AGENTLEDGER_MYSQL_DSN
 
 The Inspector does not start a server, mutate runtime state, call tools, approve requests, or contact model providers. It builds a language-neutral read model from AgentLedger runtime metadata or exported evidence bundles. AgentLedger does not add a separate permission layer for Inspector; use database grants, filesystem ACLs, and deployment policy.
 
+Static HTML reports include local section navigation and internal cross-links between related timeline events, steps, Tool Ledger rows, approvals, policy decisions, and artifacts. Custom viewers can reuse the same `anchor`, `related_refs`, and `related_links` fields from `InspectorReport.to_dict()`.
+
 Extension API:
 
 ```python

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/packages/agentledger-inspector/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentledger-inspector"
-version = "1.3.2"
+version = "1.3.3"
 description = "Read-only Inspector and evidence viewer package for AgentLedger"
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "Apache-2.0"}
 authors = [{name = "AgentLedger Contributors"}]
 keywords = ["agents", "runtime", "inspector", "debug", "evidence"]
-dependencies = ["agentledger-runtime>=1.3.2,<2"]
+dependencies = ["agentledger-runtime>=1.3.3,<2"]
 
 [project.urls]
 Homepage = "https://github.com/yaogdu/AgentLedger"

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentledger-runtime"
-version = "1.3.2"
+version = "1.3.3"
 description = "Runtime reliability layer for Agent Harness stacks"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -39,7 +39,7 @@ mcp = ["agentledger-mcp>=1.3,<2"]
 otel = ["agentledger-otel>=1.3,<2"]
 langfuse = ["agentledger-langfuse>=1.3,<2"]
 docker = ["agentledger-sandbox-docker>=1.3,<2"]
-inspector = ["agentledger-inspector>=1.3.2,<2"]
+inspector = ["agentledger-inspector>=1.3.3,<2"]
 all = [
   "agentledger-postgres>=1.3,<2",
   "agentledger-mysql>=1.3,<2",
@@ -49,7 +49,7 @@ all = [
   "agentledger-otel>=1.3,<2",
   "agentledger-langfuse>=1.3,<2",
   "agentledger-sandbox-docker>=1.3,<2",
-  "agentledger-inspector>=1.3.2,<2",
+  "agentledger-inspector>=1.3.3,<2",
 ]
 
 [project.scripts]

{agentledger_runtime-1.3.2 → agentledger_runtime-1.3.3}/src/agentledger/__init__.py

@@ -1,6 +1,6 @@
 """AgentLedger stable agent runtime core."""
 
-__version__ = "1.3.2"
+__version__ = "1.3.3"
 
 from .adapters import FrameworkAdapter, PythonFunctionAdapter, python_agent
 from .adapter_certification import AdapterCertificationBundle, build_adapter_certification_bundle, supported_adapter_certification_profiles