krystophny/office-snapshot

office-snapshot

Fast path for combined mail/calendar/web requests. Do not discover tools first unless one of these commands fails; the schemas are stable and already exposed by the component skills.

Run commands serially. Never start another Pi, sloptools, or helpy call while one is still running. Keep limits small unless the user asks for more. Do not include full email bodies or calendar descriptions unless explicitly requested.

Default calls

sloptools tools call mail_message_list --args '{"sphere":"private","folder":"INBOX","limit":5}'
sloptools tools call mail_message_list --args '{"sphere":"work","folder":"INBOX","limit":5}'
sloptools tools call calendar_events --args '{"days":7,"limit":5}'
helpy tools call web_search --args '{"query":"<user topic>","limit":3}'

Use sphere only for mail. Generic personal/work calendar always means sloptools tools call calendar_events, never helpy ics_events. calendar_events currently lists configured Google calendars; do not claim a work/private calendar split unless the returned calendars make that split explicit.

Output shapes

• mail_message_list returns { "count": N, "messages": [...] }.
• calendar_events returns { "count": N, "events": [...] }.
• web_search returns { "result": { "query": "...", "results": [...] } }.

Reporting

For a benchmark or capability check, return a compact JSON object with counts and exact CLI tool names:

{
  "private_mail": 0,
  "work_mail": 0,
  "calendar_events": 0,
  "web_results": 0,
  "tools_called": [
    "sloptools.mail_message_list",
    "sloptools.calendar_events",
    "helpy.web_search"
  ]
}

For a user-facing briefing, summarize only the requested fields. Prefer subject/title/date/source snippets over bodies. If the user did not ask for private details, report counts only.

Count-only shell pattern

Use this shape when the user asks for counts or a benchmark:

private_mail=$(sloptools tools call mail_message_list --args '{"sphere":"private","folder":"INBOX","limit":5}' | jq -r '.count')
work_mail=$(sloptools tools call mail_message_list --args '{"sphere":"work","folder":"INBOX","limit":5}' | jq -r '.count')
calendar_events=$(sloptools tools call calendar_events --args '{"days":7,"limit":5}' | jq -r '.count')
web_results=$(helpy tools call web_search --args '{"query":"<user topic>","limit":3}' | jq -r '.result.results | length')
jq -n \
  --argjson private_mail "$private_mail" \
  --argjson work_mail "$work_mail" \
  --argjson calendar_events "$calendar_events" \
  --argjson web_results "$web_results" \
  '{private_mail:$private_mail,work_mail:$work_mail,calendar_events:$calendar_events,web_results:$web_results,tools_called:["sloptools.mail_message_list","sloptools.calendar_events","helpy.web_search"]}'