refactor(agent): scope queue actions to edit and remove
This commit is contained in:
@@ -2,5 +2,5 @@
|
||||
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
||||
# after editing either side, bring the other along and re-record with:
|
||||
# pnpm run verify-translation-pairing --write docs/core-data-structures/core.md
|
||||
core.md: a39560eecca4689186ce2d3fc183250f8698cb90
|
||||
core.zh.md: a5e3b80e11c97d64de1afd082ef02097eb61787c
|
||||
core.md: dad533cee00646a40f57bd9097b2cceb8e9de9e2
|
||||
core.zh.md: 9e8afac0744fcf0df8c35dad5debce746d6614c6
|
||||
|
||||
@@ -445,11 +445,10 @@ interface InboxItem {
|
||||
```
|
||||
|
||||
```ts type-equiv
|
||||
/** A user-requested mutation of one still-pending inbox item. */
|
||||
/** A user-requested mutation of one still-pending queued occurrence. */
|
||||
type InboxAction =
|
||||
| { readonly kind: 'edit'; readonly content: ContentBlock[] }
|
||||
| { readonly kind: 'remove' }
|
||||
| { readonly kind: 'promote' }
|
||||
```
|
||||
|
||||
```ts type-equiv
|
||||
@@ -549,13 +548,11 @@ interface Agent {
|
||||
send(message: UserMessage, options: SendOptions): void
|
||||
|
||||
/**
|
||||
* Mutate one still-pending inbox occurrence synchronously. Editing preserves
|
||||
* Mutate one still-pending queued occurrence synchronously. Editing preserves
|
||||
* the message identity and queue position; removal publishes its terminal
|
||||
* discard; promotion moves it to the front of its current FIFO and makes a
|
||||
* queued item waking. A driver-claimed item is no longer pending and returns
|
||||
* `not-found`.
|
||||
* @param id - independently addressable inbox occurrence.
|
||||
* @param action - edit, remove, or promote operation.
|
||||
* discard. Steering occurrences and driver-claimed items return `not-found`.
|
||||
* @param id - independently addressable queued occurrence.
|
||||
* @param action - edit or remove operation.
|
||||
* @returns whether the pending occurrence was found and updated.
|
||||
*/
|
||||
updateInbox(id: InboxItemId, action: InboxAction): InboxActionResult
|
||||
|
||||
@@ -453,11 +453,10 @@ interface InboxItem {
|
||||
```
|
||||
|
||||
```ts type-equiv
|
||||
/** A user-requested mutation of one still-pending inbox item. */
|
||||
/** A user-requested mutation of one still-pending queued occurrence. */
|
||||
type InboxAction =
|
||||
| { readonly kind: 'edit'; readonly content: ContentBlock[] }
|
||||
| { readonly kind: 'remove' }
|
||||
| { readonly kind: 'promote' }
|
||||
```
|
||||
|
||||
```ts type-equiv
|
||||
@@ -557,13 +556,11 @@ interface Agent {
|
||||
send(message: UserMessage, options: SendOptions): void
|
||||
|
||||
/**
|
||||
* Mutate one still-pending inbox occurrence synchronously. Editing preserves
|
||||
* Mutate one still-pending queued occurrence synchronously. Editing preserves
|
||||
* the message identity and queue position; removal publishes its terminal
|
||||
* discard; promotion moves it to the front of its current FIFO and makes a
|
||||
* queued item waking. A driver-claimed item is no longer pending and returns
|
||||
* `not-found`.
|
||||
* @param id - independently addressable inbox occurrence.
|
||||
* @param action - edit, remove, or promote operation.
|
||||
* discard. Steering occurrences and driver-claimed items return `not-found`.
|
||||
* @param id - independently addressable queued occurrence.
|
||||
* @param action - edit or remove operation.
|
||||
* @returns whether the pending occurrence was found and updated.
|
||||
*/
|
||||
updateInbox(id: InboxItemId, action: InboxAction): InboxActionResult
|
||||
|
||||
Reference in New Issue
Block a user