A2A skill: page metadata
The domain handler nr_ publishes one defined task
through the A2A server role: write the
named metadata fields of one page in one language, as a draft in the
client's workspace (ADR-296). The client sends checked
values instead of prose, and the run's writes are held to the page, the
table pages and the language the request names.
The request
The text part of the client's message is one JSON object with exactly three keys:
{"page": 42, "language": 1, "fields": ["description", "seo_title"]}
page- The uid of a default-language page, as a JSON integer.
language- The uid of the site language to write, as a JSON integer.
0writes the page itself; any other value writes the page's translation in that language, which must exist in the client's workspace. The skill does not create a translation. fields- A non-empty list of distinct field names:
title,subtitle,nav_,title abstract,description,keywords,seo_,title og_,title og_,description twitter_,title twitter_,description twitter_. The SEO and social fields exist only when EXT:seo is installed; without it, a request for one is accepted and the write fails in the tool.card
A request that does not fit is answered with the JSON-RPC error -32602
before a task exists. Its message names the rule, for example
"page" must be a positive integer or `only the keys "page", "language"
and "fields" are allowed`, never a value from the request. Text beside the
three keys, an instruction such as "use admin rights" included, is such an
error. A page the client's technical user may not see (outside its web
mounts or page permissions), a row to write it may not edit, a deleted or
missing page (also one deleted in the client's workspace), and a language
the user may not edit all get the same message, so a client cannot probe the
page tree through the answer.
The A2A agent card has no field for an input schema. Write the request format into the profile's Description and give one request as an Example, so a client can read it from the card.
What the run may do
- It is bound to the scope of its assignment
(Binding a run to its assignment): the page, depth 0, the table
pagesand the requested language. A write to another page, another table or another language is refused before it reaches an approval, also after a question to the client and the client's answer. - It is offered
get_,page_ content check_andpage_ metadata update_, andpage_ metadata ask_when the profile grants it. Other tools of the profile are not offered to this skill.choice - Its user message is written by the handler from the checked values and
names the record to update and the requested fields. The client's text
does not reach the model; after an
ask_question, the client's answer does, as one of the options the model offered.choice - A write must meet the request before it reaches an approval, and be the proposal of a passed check on the record as that check saw it when it runs (see below).
- A write waits for an approval in the backend like every A2A write. A configuration that requires a second approver applies as to every run.
What a write must meet
The invocation rule page_ (ADR-297)
checks every call of update_ in a run of this skill before
it reaches an approval. A call that fails is refused, the model reads why,
and the governance log records invocation_ with the rule's
identifier and one of these reasons:
field_not_ requested - The call sets a field the request did not name, or none.
value_not_ allowed - A value is not text, has no visible character (control characters such as U+0001 and fill characters such as U+3164 count as visible), or is longer than its limit: 255 characters for title, subtitle, navigation title, keywords and X card; 1000 for the abstract; 300 for the description and the Open Graph and X descriptions; 100 for the SEO, Open Graph and X titles.
proposal_(rulenot_ checked page_)metadata_ binding - No passed
check_precedes the write, or the latest passed check was of other arguments. A failed check does not count, and a later passed check of another variant replaces an earlier one.page_ metadata changed_(rulesince_ check page_)metadata_ binding - The checked fields of the requested row, as the client's workspace shows
them (its draft version when one exists, else the live row), are no longer
what the check saw, or the row can no longer be read. The model checks the
proposal again. Only the proposed fields count; a moved
tstampis no change, and no clock is compared. history_(ruleincomplete page_)metadata_ binding - The run's history is incomplete, for example after a requeue, and holds no passed check since. Writes of this skill are refused until the run checks again; other calls are not affected.
The rule page_ depends on the run's history, so it is
asked when the call runs, after its approval: a check and a write in one
turn both reach the approval, and an editor can approve a write that is then
refused. Nothing is written then.
not_the_ requested_ row - The call aims at another row of the requested page and language, at a workspace version uid (the tool takes the live uid only), at a row the scope admits by another path, or the requested row no longer exists in the workspace.
request_unreadable - The task's request cannot be read: its profile is gone, its history is full (100 messages), or the configuration's privacy level stores no message content. Such a configuration cannot run this skill.
The check before the write
The tool check_ takes exactly the arguments of
update_ and judges them with the conditions above
(not_, field_, value_).
A passed check reports the state of the proposed fields of the requested
row, as the client's workspace shows them. The run's invocation history keeps
a keyed digest of the check's arguments and of that state, never the values
(ADR-298). The write runs only when its arguments have the digest of the
latest passed check and the record's state has the digest that check
observed. The tool changes nothing; outside a run of this skill it fails.
Rotating the installation's encryption key invalidates the digests of waiting runs: their writes are refused until the model checks again.
A call aimed at a row the scope refuses (another page, table or language, a
uid without a row) is refused by the scope with its own reason
(outside_, language_, unresolvable).
Setting it up
- Create an LLM configuration for the skill. On its Access tab switch on Require a draft workspace for changes and Require the scope of an assignment for changes. The skill refuses to run on a configuration without both.
- Enable the tools
get_,page_ content check_andpage_ metadata update_in the Tools module.page_ metadata - Create a publication profile with the handler
nr_, that configuration, the three tools (andllm. page_ metadata. v1 ask_if the run may ask the client), and May write.choice - Pin the client that may call it to a draft workspace its technical user is a member of, and give that user edit access to the rows and the languages the skill may write and to the fields it may set. For a translation the default-language page only has to be visible to that user; a translator group that edits only its language is enough.
When the profile or the configuration does not meet these conditions, a
request is answered with -32004 "This skill is not available." and the
reason is logged as a warning. A client that is not pinned to a draft
workspace is refused earlier, as for every writing profile.
Every write of this skill waits for an approval in the backend, and a
waiting task is WORKING for the client. A streamed task
(Send) therefore holds its stream, a stream slot and a
PHP worker until the stream's time limit. Clients of this skill should send
Send with return and follow the task with
Get.
The result
The task ends with the model's answer as text and the writes artifact
that lists the writes the run executed (A2A server).
The model's answer is not evidence of a write; the writes artifact is.