@holon-run/agentinbox 1.7.2 → 1.8.0

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.
@@ -133,9 +133,28 @@ when registering.
133
133
  agentinbox agent register
134
134
  agentinbox follow github pr --agent-id <agentId> --arg owner=holon-run --arg repo=agentinbox --arg number=87 --arg withCi=true
135
135
  agentinbox inbox read --agent-id <agentId>
136
+ # For an email entry selected from the list:
137
+ agentinbox inbox read <entryId> --agent-id <agentId>
138
+ # Continue only when body.hasMore is true:
139
+ agentinbox inbox read <entryId> --agent-id <agentId> --cursor <nextCursor>
140
+ # Inspect safe email attachment metadata without downloading:
141
+ agentinbox inbox attachment inspect <attachmentRef> --agent-id <agentId>
142
+ # For a source configured with attachmentPolicy.mode=store_reference:
143
+ agentinbox inbox attachment get <attachmentRef> --agent-id <agentId> --output ./attachment.bin
144
+ # Permanently remove managed access after use:
145
+ agentinbox inbox attachment delete <attachmentRef> --agent-id <agentId>
136
146
  agentinbox inbox ack --agent-id <agentId> --through <lastEntryId>
137
147
  ```
138
148
 
149
+ Email attachment refs are selectors, not bearer credentials. Always pass the
150
+ owning `agentId`; AgentInbox rechecks inbox ownership before and after provider
151
+ retrieval. The CLI writes `--output` locally with exclusive creation, while the
152
+ daemon stores only managed content-addressed objects and never accepts caller
153
+ paths. Delete attachment content when it is no longer needed; the reference is
154
+ tombstoned, audit metadata is retained, and shared objects are reclaimed only
155
+ after their last live reference is gone.
156
+ filesystem paths.
157
+
139
158
  Ack discipline:
140
159
 
141
160
  - prefer `agentinbox inbox ack --agent-id <agentId> --through <lastEntryId>`
@@ -252,6 +271,7 @@ Read and ack the inbox:
252
271
 
253
272
  ```bash
254
273
  agentinbox inbox read --agent-id <agentId>
274
+ agentinbox inbox read <entryId> --agent-id <agentId>
255
275
  agentinbox inbox ack --agent-id <agentId> --through <lastEntryId>
256
276
  agentinbox inbox send --agent-id <agentId> --message "Please review PR #87"
257
277
  agentinbox inbox watch --agent-id <agentId>