didactyl/plans/tool_naming.md

Didactyl Tool Naming — Final List

Decisions

• context_* tools merged into existing categories with proper names
• Local tools get local_ prefix
• context_user_message removed from LLM schema (template-only)
• nostr_post_readme kept — a post is different from a longform note
• nostr_file_md_to_longform_post kept as-is
• task_manage kept as-is

---

Complete Tool List (sorted by category prefix)

admin_ — Administrator Metadata

#	Name	Old Name	Description
1	admin_identity	context_admin_identity	Admin pubkey, sender tier, verification metadata

agent_ — Agent Self-Metadata

#	Name	Old Name	Description
2	agent_identity	context_agent_identity	Agent pubkey hex + npub
3	agent_version	my_version	Didactyl version and build metadata

local_ — Local / Host Tools

#	Name	Old Name	Description
4	local_shell_exec	shell_exec	Execute a shell command
5	local_file_read	file_read	Read a local file as text
6	local_file_write	file_write	Write text to a local file
7	local_http_fetch	http_fetch	Fetch HTTP/S resources

model_ — LLM / Model Management

#	Name	Old Name	Description
8	model_get	—	Get current active LLM config
9	model_set	—	Update active LLM config and persist
10	model_list	—	List available model IDs from provider

nostr_ — Nostr Protocol Tools

#	Name	Old Name	Description
11	nostr_post	—	Publish a Nostr event to connected relays
12	nostr_post_readme	—	Publish README.md as kind 30023
13	nostr_file_md_to_longform_post	—	Read markdown file and publish as kind 30023 longform
14	nostr_delete	—	Request deletion of events — NIP-09 kind 5
15	nostr_react	—	React to event — NIP-25 kind 7
16	nostr_query	—	Query events from relays using a filter
17	nostr_profile_get	—	Look up kind 0 profile by pubkey
18	nostr_nip05_lookup	—	Look up/verify NIP-05 identifier
19	nostr_admin_profile	context_admin_profile	Get admin kind 0 profile from cache
20	nostr_admin_contacts	context_admin_contacts	Get admin kind 3 contacts from cache
21	nostr_admin_relays	context_admin_relays	Get admin kind 10002 relay list from cache
22	nostr_admin_notes	context_admin_notes	Get admin kind 1 recent notes from cache
23	nostr_dm_send	—	Send NIP-04 encrypted DM
24	nostr_dm_send_nip17	—	Send NIP-17 gift-wrap DM
25	nostr_encrypt	—	Encrypt plaintext — NIP-44
26	nostr_decrypt	—	Decrypt ciphertext — NIP-44
27	nostr_encode	—	Encode entity into nostr: URI
28	nostr_decode	—	Decode bech32/nostr: URI
29	nostr_pubkey	—	Return agent pubkey hex
30	nostr_npub	—	Return agent pubkey as npub
31	nostr_relay_status	—	Get connection status for all relays
32	nostr_relay_info	—	Fetch NIP-11 relay info document
33	nostr_list_manage	—	Add/remove tags in replaceable list events — NIP-51

skill_ — Skill Management

#	Name	Old Name	Description
34	skill_create	—	Create/update skill definition
35	skill_list	—	List agent published skills
36	skill_adopt	—	Adopt a skill — add to kind 10123
37	skill_remove	—	Remove skill from adoption list
38	skill_search	—	Search public skills

task_ — Task Management

#	Name	Old Name	Description
39	task_manage	—	CRUD for agent task memory
40	task_list	context_tasks	Get current task list — read-only

Template-Only (not in LLM schema)

#	Name	Old Name	Description
41	message_current	context_user_message	Current user message text — template assembly only

---

Summary of Changes

Old Name	New Name	Change Type
context_admin_identity	admin_identity	Rename
context_agent_identity	agent_identity	Rename
context_admin_profile	nostr_admin_profile	Rename + recategorize
context_admin_contacts	nostr_admin_contacts	Rename + recategorize
context_admin_relays	nostr_admin_relays	Rename + recategorize
context_admin_notes	nostr_admin_notes	Rename + recategorize
context_tasks	task_list	Rename + recategorize
context_user_message	message_current	Rename + remove from LLM schema
my_version	agent_version	Rename
shell_exec	local_shell_exec	Add prefix
file_read	local_file_read	Add prefix
file_write	local_file_write	Add prefix
http_fetch	local_http_fetch	Add prefix

Total: 13 renames, 0 removals, 0 additions