Update to Solibo Home

{
  "description": "Board meetings (styremøter, årsmøter) in a housing community in Solibo Home: find the next meeting, prepare a briefing or packet, add cases to the agenda, reorder or follow up items, create a meeting, update participants, send summons, record attendance and signing. Use when the user mentions a meeting, agenda, saksliste, innkalling, protocol, or wants to put a case (sak) on a meeting.",
  "included_files": [
    {
      "relative_path": "references/tool-notes.md",
      "size_in_bytes": 5366
    }
  ],
  "name": "meeting-agenda",
  "skill_md_contents": "---\nname: meeting-agenda\ndescription: \"Board meetings (styremøter, årsmøter) in a housing community in Solibo Home: find the next meeting, prepare a briefing or packet, add cases to the agenda, reorder or follow up items, create a meeting, update participants, send summons, record attendance and signing. Use when the user mentions a meeting, agenda, saksliste, innkalling, protocol, or wants to put a case (sak) on a meeting.\"\n---\n\n# Meeting agenda\n\n## Find and prepare\n\n1. Resolve the company; `set_working_company` for a session about one company.\n2. `search_meetings` with `companyId`; results come newest planned start first, so the nearest meeting is\n   last. For \"the next meeting\" pass `meetingDateFrom` today and `meetingDateTo` a few months ahead, follow\n   `paging.next` if present, and pick the row with the earliest future `plannedStartAt`. `status` filters\n   take raw values (PLANNING, NOTIFIED, IN_PROGRESS, TO_SIGN, SIGNED). The user often knows the date, not\n   the id.\n3. `get_meeting_prep` with `meetingId` is the briefing: `meeting`, `agendaIssues[]` (issue id, title,\n   status, responsible, description), `recentConversations[]`, `boardSummary`, `answerGuidance`. Drill into\n   `get_issue` for proposed resolutions and comments, `search_documents` for board papers (type MEETING or\n   ANNUAL_MEETING, or the subject words), and `get_conversation` for a referenced thread.\n4. `get_meeting` only when participant details, RSVP, attendance or the agenda order (`issues[].sequence`)\n   are needed; contact fields only with `includeFields`.\n\nA briefing is read-only: it changes nothing and notifies nobody. Say so, and say which parts are samples.\n\n## Put a case on the agenda\n\nAn agenda item is an issue (sak) attached to a meeting. A new one is a single preview and confirmation:\n\n1. `create_issue` with `title`, `description`, `responsibleId` (a person id from `search_persons`,\n   `lookup_person` or the `personId` of `get_current_user`) and `meetingId` in the same call; `beforeIndex`\n   (zero-based) places it, omitting it appends. Do not create a bare title and update it afterwards. Confirm\n   with `confirm_pending_write`; the result holds the issue `id` and `agendaOutcome`. FAILED means the issue\n   exists but is not on the agenda: follow `agendaNote`, which says whether the refusal is final (no access,\n   or Solibo Home rejected the change) or whether `add_issue_to_meeting` with that `issueId` is the next step;\n   never create the issue again. UNKNOWN means Solibo Home did not answer the agenda step: read the agenda with `get_meeting`\n   first, and attach only if the issue is missing, because attaching twice duplicates the item.\n2. Existing cases come from `search_issues` (`status` [\"OPEN\"]) and go on the agenda with\n   `add_issue_to_meeting` (`meetingId`, `issueId`, optional `beforeIndex`).\n\nSeveral cases for one meeting: one preview and one confirmation per case, in order, and tell the user how\nmany confirmations to expect. For the same case in many companies use `create_issues_for_companies` with\n`companyIds` and `titleTemplate`; it does not attach to meetings.\n\nLater changes: `update_issue` (title, description, `proposedResolution`), `update_issue_report` for the\nprotocol text, `update_issue_conclusion` with the final `resolution`, `update_issue_responsible`,\n`create_issue_comment`, `add_issue_conversation` and `add_issue_section` to link a thread or a section,\n`reorder_meeting_issue` (`beforeIndex`), `remove_issue_from_meeting` (the case survives), `close_issue`\nand `reopen_issue`.\n\n## Create or change a meeting\n\n- `create_meeting` with `title`, `plannedStartAt` and `plannedEndAt` as full timestamps with offset\n  (\"2026-11-12T18:00:00+01:00\"), `location`. It sends no summons. For many companies,\n  `create_meetings_for_companies` with `companyIds`, `titleTemplate` and the two times.\n- `update_meeting` changes times, `location` or `comment`; `sendUpdatedNotification` true emails\n  participants and needs the user's explicit wish.\n- `update_meeting_participants` replaces the bucket you pass (`participantIds`, `guestParticipantIds`,\n  `externalParticipants`); omitted buckets are kept, an empty list clears one. Added or removed people\n  may be emailed if the meeting was already notified.\n- `send_meeting_summons` (optional `comment`) notifies every participant of the meeting: board members,\n  guests and external participants alike. Show the participant list from `get_meeting` first so the user\n  approves the whole audience; it is a communication preview confirmed with `confirm_pending_communication`,\n  only after the user approves the meeting, the audience and the text.\n\n## During and after the meeting\n\n`start_meeting`, `mark_meeting_attendance` (`participantId`, `attended`), `mark_meeting_issue_treated`\n(one-way), `set_meeting_issue_follow_up` (`shouldFollowUp`), `close_meeting`, `reopen_meeting`.\nSigning: `send_meeting_signature_reminder` (`idsToSign`, communication confirm),\n`mark_meeting_participant_signed` (`attendeeId` from `get_meeting`), `finalize_meeting_signing` (forces\nsigned; Solibo superuser only). `rsvp_meeting` records YES, NO or MAYBE for a participant (`participantId` from `get_meeting`). Follow-up to-dos that\nare not cases go in `create_task` (`title`, `dueDate` as a timestamp, `responsibleId`).\n\n## Guardrails\n\n- Every write is a preview followed by `confirm_pending_write` (or `confirm_pending_communication` for\n  summons, reminders and RSVP) with only `previewId` and `confirmed` true.\n- Ask for the missing meeting, time, case text or responsible person before the preview; never invent them.\n- Report the item as added only after an executed confirmation; a DRY_RUN result changed nothing.\n\n`references/tool-notes.md` lists the arguments and result fields of every tool named here.\n"
}