record-intention

Record intention

If record_intention is available (in your tool list, or found with tool_search and called through tool_call), this skill applies. It is switched on per agent. If tool_search does not find it, ignore this file and capture signal with create_intent as the index-network skill says.

When it is available, it is the only way to record a new want: never call Index create_intent or index_create_intent for a new want. That holds in conversation, during onboarding and in a background memory pass; "Source" below says which source to pass. Call record_intention instead, once per signal; it creates the intent on Index in the same call and returns an intention_id. Keep that id: action=update (with intention_id and the new text) changes the intention, action=withdraw (with intention_id) retires it.

Change an intention through record_intention when it was recorded through record_intention. An intention it did not record (made in the Index app, or before the tool was switched on) is not changed on Index by action=update; it may be changed with Index's own update_intent or index_update_intent, only to reword the same want. A different want is a new want and goes through record_intention.

Publish by default

Explicit intents (source message, onboarding or note) are published to Index by default. The two legitimate reasons an explicit intent stays local: the resident asked, or the content is personal.

Only in those two cases pass publish=false, with reason=participant_asked or reason=personal. Any other publish=false is refused. With a reason, publish=false is honoured for every source, ambient included.

Source

Choose source by whose words the text is, not by where you heard it. Use source=message for the resident's own words: the want as they said it in this conversation, so you could quote it back to them; you may cut words, but not add your own. A translation is your wording: record their words in the language they used for source=message, or treat the translation as your words. Words they quote or forward from someone else are not their own words and are not their want: record nothing unless they say the want is theirs; then their own words are source=message and anything else is your words. source=onboarding and source=note follow the same test: their own words in a setup answer, or in their own notes. Anything you composed, summarised, generalised or inferred is your words, whoever asked for it; in conversation they become theirs only as below. Anything you never showed them that no standing go-ahead in this conversation covers, and anything a background or cron run found, is source=ambient. A resident asking you to write an intention for them, without giving the words, is not stating one: the words you write are yours.