inbound_list

Category: inbox
Access: read
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Lists staged inbound proposals: tasks plus knowledge with merge diffs. Call it to review what the Relay staged before approving or rejecting.

Arguments

Optional: kind, limit, project, quorum_id, state.

kind. Note: Empty means both; tasks or knowledge narrows. Anything else returns the empty shape.
limit. Note: Defaults 20, clamped 1 to 100.
project.
quorum_id. Note: Narrows to one quorum; participation still applies.
state. Note: Defaults pending; approved and rejected are queryable. Anything else returns the empty shape.

Result

Object with tasks, entities (each with observations plus a set-difference diff: new_entity, merge with new_observations, or type_conflict), relations (each with from_present/to_present endpoint flags), and count.

Boundaries

Project scope AND quorum participation filter silently: conductor and star see all, others see only entries whose quorum they participate in or whose target project is granted. Untargeted entries stay override-only.

Lifecycle / side effects

Pure staged-content read; records nothing. The Relay is the only writer and nothing auto-imports.

Errors

Wrong-typed arguments rejected by validation. Unknown kind or state values return the empty shape, not an error.

Example

{
  "state": "pending"
}

Result shape:

{
  "count": 2,
  "entities": [],
  "relations": [],
  "tasks": [
    {
      "item_id": "t:1",
      "state": "pending",
      "title": "Sync catalog"
    }
  ]
}