Omnes methodi invocantur per POST ad https://www.magisterium.com/api/v1/a2a utendo JSON-RPC 2.0. Unaquaeque postulatio debet includere Authorization: Bearer $MAGISTERIUM_TOKEN (pignus usuarii per OAuth emissum — vide Authentication) et Content-Type: application/json.

Methodi

message/send

Mitte nuntium ad facultatem et accipe munus completum. Omnes facultates Magisterii synchronae sunt — responsum continet statum terminalem muneris (completed vel failed), numquam statum intermedium working.

Parametri:

Campus	Typus	Necessarius	Descriptio
message	Message	Ita	Nuntius usuarii cum partibus et metadata optionali.
message.role	string	Ita	Debet esse "user".
message.messageId	string	Ita	ID unica huic nuntio.
message.kind	string	Ita	Debet esse "message".
message.parts	Part[]	Ita	Saltem una pars (text aut data).
message.metadata.skillId	string	Non	Facultas invocanda. Praesumptum est catholic_qa.
message.contextId	string	Non	ID contextus optionale ad munera coniuncta congregare. Si omittitur, serviens unam generat.
configuration	object	Non	Reservatum pro usu futuro.

Reddit: Obiectum Task cum kind: "task".

tasks/get

Recupera munus antea creatum per eius ID.

Parametri:

Campus	Typus	Necessarius	Descriptio
id	string	Ita	ID muneris redditum ex message/send.

Reddit: Obiectum Task, aut errorem TASK_NOT_FOUND si exspiravit vel deest. Munera per 24 horas servantur.

tasks/cancel

Rescinde munus si est in statu rescindibili. Quia omnes facultates synchrone resolvuntur, plurima munera iam sunt in statu terminali (completed / failed) quando responsum redit — conatus rescindendi munus terminale reddit INVALID_PARAMS cum nuntio Invalid state transition.

Parametri:

Campus	Typus	Necessarius	Descriptio
id	string	Ita	ID muneris rescindendi.

Reddit: Obiectum Task renovatum cum status.state: "canceled".

Vitae Cursus Muneris

Facultates Magisterii synchrone currunt, itaque munus in memoriam reponitur tantum postquam facultas perficitur — semper in statu terminali. Status submitted et working partes sunt amplioris specificationis A2A, sed ab implementatione Magisterii numquam producuntur; semper unum tantum ex tribus statibus terminalibus infra positis observabis.

Status	Significatio
completed	Terminalis — resultata in artifacts sunt. Reditur a message/send cum facultas feliciter perficitur.
failed	Terminalis — status.message causam defectus continet. Reditur a message/send cum facultas exceptionem iacit.
canceled	Terminalis — solum attingibilis vocando tasks/cancel super munus non terminale. Quia munera iam terminalia sunt quando message/send redit, in praxi rescissio reicitur cum INVALID_PARAMS pro quolibet munere cuius manubrium habes.

Unumquodque munus etiam fert:

• contextId — identificator congregationis quem in nuntiis sequentibus reuti potes ad munera coniuncta conectenda.
• history — index ordinatus nuntiorum usuarii et agentis qui artefacta muneris produxerunt.

Codices Errorum

Codex	Nomen	Descriptio
-32700	Parse error	Corpus JSON invalidum.
-32600	Invalid request	Campi jsonrpc, method, aut id desunt.
-32601	Method not found	Methodus JSON-RPC ignota.
-32602	Invalid params	Parametri deficientes aut invalidi (etiam redditur pro transitionibus status tasks/cancel invalidis).
-32603	Internal error	Defectus inopinatus ex parte servientis.
-32001	Task not found	ID muneris non exstat aut exspiravit.
-32002	Skill not found	skillId ignota in metadata nuntii.
-32003	Rate limit exceeded	Nimiae postulationes. Verifica retryAfter (secunda) in erroris data.
-32004	Unauthorized	Pignus Bearer deficiens aut invalidum.
-32005	Paid plan required	A2A consilium Pro, Organization, vel Enterprise requirit.

Status HTTP classem erroris speculatur: 401 pro UNAUTHORIZED, 403 pro PLAN_REQUIRED, 429 pro RATE_LIMITED, et 200 pro omnibus aliis erroribus JSON-RPC (secundum conventionem JSON-RPC reddendi 200 cum corpore error).

Limites Rate

A2A eandem copiam rate-limit communicat ac MCP — vide Pretium MCP pro summis postulationum per consilium.

Duae variantes coguntur:

• Default — applicatur ad document_search, document_fetch, liturgical_readings, et saints_of_the_day.
• Expensive — applicatur solum ad catholic_qa, quia fistulam responsi ab LLM sustentatam currit. Haec variante utitur summa strictiore et humiliore.

Cum limitem attingis, obiectum erroris data continet retryAfter in secundis. Vocatores pro illo intervallo retrocedere debent antequam retentent.

CORS

Terminus respondet postulationibus praecursoriis OPTIONS et reddit capita CORS permissiva (Access-Control-Allow-Origin: *, Allow-Methods: POST, OPTIONS, Allow-Headers: Content-Type, Authorization), ita ut A2A ex dispositoribus in navigatoribus fundatis sine proxy invocari possit.