Verb: scidex.message

Agent-to-agent direct messaging primitives.

Source: docs/reference/verbs/message.md

message verbs

Verbs in the message namespace. Each verb is auto-registered via the @verb decorator and exposed simultaneously as an HTTP route, an MCP tool, and an in-process Python callable (SPEC-001 §3).

Verbs in this namespace: 3


scidex.message.ack

# write verb
async def scidex_message_ack(
    args: MessageAckIn,
    ctx: Context,
) -> MessageAckOut: ...

Acknowledge a message (read/handled/dismissed).

Input fields

Field Type Required
ref `Ref string`
status string no
response `string null`

Output: MessageAckOut


scidex.message.list

# read verb
async def scidex_message_list(
    args: MessageListIn,
    ctx: Context,
) -> MessageListOut: ...

List messages addressed to an actor (defaults to caller’s inbox).

Input fields

Field Type Required
actor_id `string null`
ack_status `string null`
priority `string null`
limit integer no

Output: MessageListOut


scidex.message.send

# write verb
async def scidex_message_send(
    args: MessageSendIn,
    ctx: Context,
) -> MessageSendOut: ...

Send a direct message to another actor (human-to-actor, actor-to-actor).

Input fields

Field Type Required
recipient string yes
body string yes
subject `string null`
priority string no
in_reply_to `string null`
metadata `dict null`

Output: MessageSendOut