francwa
2db3198ef2
Adds YAML specs for the 14 tools that were still description-from-docstring:
filesystem:
- set_path_for_folder, list_folder, analyze_release, probe_media,
move_media, manage_subtitles, create_seed_links, learn
api:
- find_media_imdb_id, find_torrent, get_torrent_by_index,
add_torrent_to_qbittorrent, add_torrent_by_index
language:
- set_language
Each spec follows the established shape (summary / description /
when_to_use / when_not_to_use / next_steps / parameters with
why_needed + example / returns) and the Python function docstring is
slimmed to a one-line pointer.
Registry now reports: 21 tools, 21 with YAML spec, 0 doc-only.
48 lines
1.3 KiB
YAML
48 lines
1.3 KiB
YAML
name: set_language
|
|
|
|
summary: >
|
|
Set the conversation language so all subsequent assistant messages
|
|
match it.
|
|
|
|
description: |
|
|
Persists an ISO 639-1 language code in short-term memory under
|
|
conversation.language. Read by the prompt builder and any tool that
|
|
needs to localise output. Does not validate the code against an ISO
|
|
list — the LLM is trusted to pass a sensible value.
|
|
|
|
when_to_use: |
|
|
As the very first call when the user writes in a language different
|
|
from the current STM language. Doing it before answering avoids a
|
|
mid-reply switch.
|
|
|
|
when_not_to_use: |
|
|
- On every turn — only when the language actually changes.
|
|
- To pick a subtitle language — that lives in SubtitlePreferences,
|
|
not the conversation language.
|
|
|
|
next_steps: |
|
|
- After success: continue the user's request in the newly set
|
|
language.
|
|
|
|
parameters:
|
|
language:
|
|
description: ISO 639-1 language code (en, fr, es, de, ...).
|
|
why_needed: |
|
|
Identifies the target language unambiguously across the UI and
|
|
any localisation logic.
|
|
example: fr
|
|
|
|
returns:
|
|
ok:
|
|
description: Language saved.
|
|
fields:
|
|
status: "'ok'"
|
|
message: Confirmation message.
|
|
language: The language code that was saved.
|
|
|
|
error:
|
|
description: Could not save the language.
|
|
fields:
|
|
status: "'error'"
|
|
error: Short error code or exception message.
|