lists

Manages simple text lists stored locally on the device – no internet, no cloud.

Tool: file_storage

All list operations use the file_storage tool.

IMPORTANT: All file_storage calls for lists MUST include type: "list" parameter.

Data format: One list = one file. Each item is stored on its own line.

File names: Lowercase list name, e.g. shoppinglist, todo, packlist.

---

Workflow: Add an item

Examples: "Add milk to the shopping list" / "Put milk on the shopping list"

1. file_storage → read with filename: "shoppinglist", type: "list" → read existing items
2. Check whether the item is already present (if yes: tell the user, do nothing)
3. Append the new item at the end
4. file_storage → write with filename: "shoppinglist", type: "list", and the updated content (all lines, one item per line)
5. Confirm: "Milk has been added to the shopping list."

---

Workflow: Remove an item

Examples: "Remove milk from the shopping list" / "Delete milk from the shopping list"

1. file_storage → read with filename: "shoppinglist", type: "list"
2. File does not exist → "The shopping list is empty or does not exist."
3. Remove matching line(s) (case-insensitive, partial match allowed)
4. file_storage → write with filename: "shoppinglist", type: "list", and the cleaned content
5. Confirm: "Milk has been removed from the shopping list."
6. No match found → "Milk is not on the shopping list."

---

Workflow: Read / show a list

Examples: "What's on the shopping list?" / "Show me my shopping list"

1. file_storage → read with filename: "shoppinglist", type: "list"
2. File empty or missing → "The shopping list is empty."
3. Enumerate items: "Your shopping list contains: milk, bread, eggs."

---

Workflow: List all lists

Examples: "Which lists do I have?" / "What lists are there?"

1. file_storage → list (no filename needed, but note that only files with type: "list" are shown in the lists screen)
2. No files → "You have no lists saved yet."
3. List the names: "You have the following lists: shoppinglist, todo, packlist."

---

Workflow: Check whether an item is on a list

Examples: "Is milk already on the shopping list?" / "Is bread on the list?"

1. file_storage → read with filename: "shoppinglist", type: "list"
2. Search for the item (case-insensitive)
3. Found → "Yes, milk is already on the shopping list."
4. Not found → "No, milk is not on the shopping list yet."

---

Workflow: Delete an entire list

Examples: "Delete the shopping list" / "Clear the shopping list"

1. file_storage → delete with filename: "shoppinglist" (type parameter not needed for delete)
2. Confirm: "The shopping list has been deleted."

---

Examples

• "Add milk to the shopping list" → add item (use type: "list" in file_storage calls)
• "Add bread and butter to the shopping list" → add multiple items in one go (one read with type: "list", then one write with type: "list" and all new items appended)
• "What's on the shopping list?" → read list (use type: "list")
• "Remove milk from the shopping list" → remove item (use type: "list" in file_storage calls)
• "Is milk already on the shopping list?" → check item (use type: "list")
• "Which lists do I have?" → list all lists
• "Create a packing list" → create new empty file (write with type: "list" and empty content)
• "Delete the shopping list" → delete file