Skip to content

docs(resources): define owner-scoped recoverable references - #252

Closed
627150795 wants to merge 1 commit into
openpi-dev:mainfrom
627150795:docs/issue-157-resource-reference-contract
Closed

docs(resources): define owner-scoped recoverable references#252
627150795 wants to merge 1 commit into
openpi-dev:mainfrom
627150795:docs/issue-157-resource-reference-contract

Conversation

@627150795

Copy link
Copy Markdown
Contributor

Problem

OpenPI produces Subagent, Workflow, Background Terminal, Session, and external resources, but their references have different identities, owners, retention, and recovery guarantees. A process-global router would risk crossing those boundaries.

Value

This defines a thin, owner-scoped reference contract for exact artifacts, bounded projections, persistence, replay, branches, permissions, invalidation, and typed failures. It makes recovery paths explicit without treating paths or IDs as capabilities.

Approach

Added a focused design document and linked it from the design index. The contract keeps each existing owner responsible for storage and resolution, treats resolved content as untrusted data, and recommends shared validation only when multiple owners need the same serialization.

Validation

  • git diff --cached --check
  • bun run lint
  • bun run typecheck

Impact

Documentation-only; no resource router, API, UI, artifact store, replay, or runtime behavior changes.

Fixes #157

@tt-a1i

tt-a1i commented Aug 29, 2026

Copy link
Copy Markdown
Collaborator

Thank you for preserving this research. We are closing this PR as a source record for the Capability, authority, and resources consolidation tracked in #277. This is not a finding that the content is wrong. The current queue contains overlapping contracts from one stale base, so we will extract only settled boundaries into at most one successor record, citing this PR explicitly. Please do not spend time rebasing this branch.

@tt-a1i tt-a1i closed this Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

design: 研究跨能力的可恢复资源引用,但不引入 OpenPI 全局资源路由器

2 participants