Files
didactyl/plans/tool_naming.md
T

118 lines
5.0 KiB
Markdown

# 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**