Reference

Waits

A durable external wait owned by a Session, optionally by its exact Goal.

Checked 2026-09-28

A durable external wait owned by a Session, optionally by its exact Goal. Readiness conserves observed evidence and does not authorize inference.

Service Sylphx Agents · Resource type agents.sylphx.com/AgentSessionWait · Name pattern orgs/{org}/projects/{project}/envs/{env}/agent_sessions/{agent_session}/waits/{wait} · Shape record

#Fields

Field	Type	What it is
name	string	Exact name; the final segment is the conserved wait UUID.
uid	string	Immutable platform Resource UID. Output only.
meta	ResourceMeta	Standard metadata. Output only.
goal	string	Optional exact Goal in this Session, never a current-Goal selector.
type	string	time or signal. Other producer types require their own admitted adapter. Required.
reference	string	Exact source reference for a signal; empty for a timer.
deadline	timestamp	Actual future due time; required only for a timer.
resume_prompt	string	What to do after observing this wait's evidence, at most 16 KiB. Required.
state	string	active, ready, resolved or cancelled. Ready still requires turn admission. Output only.
evidence	struct	Original bounded observed evidence, retained through delivery and restart. Output only.
resumed_turn	int64	The only turn that consumed this wait; unset until resolved. Output only.
create_time	timestamp	Creation time. Output only.
update_time	timestamp	Last state change time. Output only.

#Methods

Every method of the collection, in the registry's order, with the scope it needs. The full request, response and examples are one link away.

Method	Call	What it does
POST	create	Creates a durable wait on an idle Session, with permanent operation replay.
GET	get	Reads an exact wait and its retained evidence.
GET	list	Lists durable waits, including ready undelivered owners.
POST	resolve	Records observed signal evidence or checks a timer against its actual due time.
POST	cancel	Cancels only this exact undelivered wait; repeated operations retain receipts.

#create

Creates a durable wait on an idle Session, with permanent operation replay.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits · scope agents:sessions · effect write · Request, response and examples

#get

Reads an exact wait and its retained evidence.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait · scope agents:sessions · effect read · Request, response and examples

#list

Lists durable waits, including ready undelivered owners.

GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits · scope agents:sessions · effect read · paginated · Request, response and examples

#resolve

Records observed signal evidence or checks a timer against its actual due time.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait:resolve · scope agents:sessions · effect write · Request, response and examples

#cancel

Cancels only this exact undelivered wait; repeated operations retain receipts.

POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait:cancel · scope agents:sessions · effect write · Request, response and examples