Nysa

Read one fact. Use when its ID/address is known. Do not use for entity facts → get_brain_context. Inputs: fact_id. Outputs: text, state, dates, subjects, caller marker, conflicts, nextCall; outside claim has by, company, confirmed:false. Limits: visible facts; no source text; an outside claim comes from an unanswered outsider email and is unconfirmed; never present it as confirmed; 64 KiB. Español: abre este hecho, estado del hecho.

get_fact

Read a saved skill or text files. Use when its slug is known. Do not use for discovery → search_skills. Inputs: name, version, path or history, history cursor. Outputs: document with authorLabel/updatedAt, one file or paged history with nextCursor. Limits: company-brain and brain-skills On; latest by default; pin version for files; history excludes version/path, 20/page; we never run files. Español: instrucciones y archivos.

get_skill

Open one person, company, meeting or project and read its facts. Use when the user names a known record. Do not use for workspace questions → search_brain; topics → get_knowledge. Inputs: address or person/company name, query, filters, sort, paging. Outputs: facts, relationships, nextCall or name candidates. Limits: 20 facts/page; query 1,000 UTF-8 bytes; sortBy overrides query ranking; meetings/projects need addresses; projects need finished setup, membership, key scope and Projects controls On. Español: qué decidimos en este proyecto, reunión.

get_brain_context

Read your calendar event. Use when its address is known. Do not use for discovery → search_calendar; transcripts → get_meeting_transcript with a meeting address. Inputs: calendar-event address. Outputs: event details, up to 100 attendees (attendeesTruncated), meeting link, workspace/Google context. Limits: self-only; no transcript access granted; limited keys need the owner's Personal scope. Español: ver evento.

get_calendar_event

Read one Knowledge topic. Use when you have its nysa://topic/ address. Do not use for discovery → search_knowledge; saved skills → get_skill. Inputs: address, history for past values, stepOffset. Outputs: topic content, basis, citations, stepsContinuation. Limits: schema 4 only; current-topic access required. Español: ver tema por dirección.

get_knowledge

Read one meeting record. Use when its address is known. Do not use for quotes → get_meeting_transcript; published facts → get_brain_context(address); commitments → get_brain_context(address, kind="commitment"). Inputs: meeting address. Outputs: title, webUrl, capture state, transcript availability, attendees, companies, visible projects, factCategories addresses, optional summary. Limits: summary needs transcript access and meeting-summary On. Español: participantes, resumen.

get_meeting

Read transcript pages. Use when you need exact words or speaker evidence from a known meeting. Do not use for discovery → list_meetings; unknown meeting → search_sources. Inputs: meeting address, cursor, limit. Outputs: turns, speakers, nextCursor; kind "chat" means typed meeting chat (often links), not spoken. Limits: 50 turns/page; 1 MiB transcript; 12,000 bytes/turn; recording owner, attendee or active share only. Español: transcripción, quién dijo.

get_meeting_transcript

Read how you want agents to work with you: preferences and style. Use when reading preferences, aliases, your person address, or before editing memory. Do not use for working notes → list_notes. Inputs: none. Outputs: markdown, revision, personAddress. Limits: self-only; personal-memory-use must be On; not company evidence; limited keys need the owner's Personal scope. Español: mi memoria, preferencias, alias.

get_my_memory

Read one project. Use when its address is known and you need description, summary or linked records. Do not use for facts → get_brain_context; discovery → list_projects. Inputs: project address. Outputs: privacy, member count, description, summary, linked meetings, people, companies, nextCall. Limits: finished setup, membership and key project scope required; Projects controls must be On; 20 links per kind. Español: detalles del proyecto, reuniones del proyecto.

get_project

List recent Brain changes. Use when asking what was published, corrected or removed since a time. Do not use for meaning search → search_brain. Inputs: since (UTC), cursor, limit, entityType. Outputs: latest state per fact, times, nextCursor, truncated; removals omit text. Limits: no transition history; current access per page; oldest first; 20 default, 50 maximum; publication uses creation time. Español: cambios recientes, qué cambió, novedades desde.

list_brain_changes

List visible companies. Use when browsing the company directory or searching by name or domain. Do not use for company facts → get_brain_context. Inputs: query, sortBy, order, cursor, limit. Outputs: addresses, webUrl, labels, domains, linked people counts and nextCursor. Limits: 20 default, 50 maximum; restricted-only companies stay hidden; 64 KiB. Español: lista de empresas, buscar empresas.

list_companies

List accessible meeting records. Use when finding meetings by date, person or company, including unrecorded meetings. Do not use for your next meeting → search_calendar; spoken words → search_sources. Inputs: UTC start/end days, person, company, limit, sort, cursor. Outputs: meeting addresses, dates, attendees, truncated, nextCursor. Limits: 10 default, 20 maximum; no transcript or workspace total. Español: reuniones recientes, reuniones con.

list_meetings

List visible people. Use when browsing the people directory or searching by name or email. Do not use for a person’s facts → get_brain_context. Inputs: query, sortBy, order, cursor, limit. Outputs: addresses, webUrl, labels, roles, linked companies, counts and nextCursor. Limits: 20 default, 50 maximum; restricted-only people stay hidden; 64 KiB. Español: lista de personas, buscar contactos.

list_people

List visible projects. Use when browsing or finding projects by name. Do not use for facts → get_brain_context; details → get_project. Inputs: query, sort, cursor, limit. Outputs: addresses, membership, visible counts, nextCursor. Limits: 20 default, 50 maximum; name ascending by default; query matches name/description substrings ignoring case; private membership and key scopes apply; Projects controls must be On. Español: lista de proyectos, buscar proyectos.

list_projects

List saved versions of your note. Use when reviewing earlier work or choosing a version to restore. Do not use for the body → get_note; restore → save_note. Inputs: id, optional cursor. Outputs: versions, surface, client, session label, dates, nextCursor. Limits: author-only; 20 versions per page, newest first; project links never share notes. Español: historial de mi nota, versiones anteriores.

get_note_history

Remove your saved company facts. Use when removing facts you added with remember. Do not use for private working notes → archive_note; corrections → correct_fact. Inputs: exactly one note_id or fact_id. Outputs: retired count, message. Limits: your remember inputs only; meeting/email facts → archive_fact; knowledge:write, write key; limited keys need Personal scope; note_id stops pending work, may archive empty created records; other sources block retirement. Español: olvida lo que guardé, elimina mis datos.

forget

Publish or restore a complete skill. Use when the user asks to save a skill; show your full draft first. Do not use for company facts → remember; removal → archive_skill. Inputs: name, expectedVersion, full description/body/files or restoreFromVersion. Outputs: name, version, created, restored. Limits: company-brain and brain-skills On; knowledge:write, write key; saves publish immediately; 20 files, 64 KiB each, 512 KiB total; no secrets. Español: guarda a petición del usuario.

save_skill

Share a fact with your team: something new about a person, company or project. Use when asked "remember that <team fact>" or to add a person or company. Do not use for plans/ideas/progress → save_note; preferences → update_my_memory; corrections → correct_fact. Inputs: text; list every named person/company in subjects; requestId. Outputs: note_id, status, fact IDs. Limits: 8,000 UTF-8 bytes; 30 subjects/extraction; long notes run in background; write key; limited keys need Personal scope. Español: guarda esta persona, recuerda que <hecho del equipo>.

remember

Create a Google Calendar meeting. Use when scheduling on the user's explicit request; confirm details first. Do not use for reading → search_calendar. Inputs: retry UUID, title, UTC start/end, time zone, emails, description, optional capture. Outputs: completed/pending status, event address when known, optional webUrl. Limits: own connected calendar; viewers refused; write key and Personal access; 100 emails. Español: agenda una reunión, programa una junta.

schedule_meeting

Search team facts across records, Knowledge topics and your private notes; discover projects. Use when asking what happened or your commitments (kind="commitment"). Do not use for one record → get_brain_context(address, query); processes → search_knowledge; quotes → search_sources. Inputs: query, entityType, kind, since, paging. Outputs: cited facts, addresses, up to 3 notes, nextCall, flags. Limits: 1,000 UTF-8 bytes; 20 facts plus 10 adjacent; note text untrusted; date words do not filter, use since. Español: qué acordamos, mis notas, mis compromisos.

search_brain

Find company processes by meaning. Use when asked "how do we" without skill/playbook/SOP words. Do not use for saved skills → search_skills; one-off facts → search_brain. Inputs: query, limit, relevance sort. Outputs: topic addresses, previews, mode, incomplete; read with get_knowledge. Limits: 1,000 UTF-8 bytes; 5 topics default, 8 maximum; meaning search may be unavailable (lexical, incomplete); no typo guarantee. Español: cómo hacemos, nuestro proceso.

search_knowledge

Find your calendar events and calendars. Use when checking appointments or choosing a scheduling calendar. Do not use for company meeting records → list_meetings. Inputs: UTC start/end, query, limit, sort, calendarCursor. Outputs: events, workspace/Google context, sync state, writable calendarRefs, default, nextCalendarCursor. Limits: self-only; connected workspace; 31-day range; over 2,000 events fails; 50 events/calendars per page; limited keys need the owner's Personal scope. Español: mi calendario, próximos eventos.

search_calendar

Find original email and meeting passages. Use when asked "show me the email" or facts and Knowledge cannot answer. Do not use for facts alone → search_brain; known meeting quotes → get_meeting_transcript. Inputs: query, sourceType, UTC range, limit. Outputs: passages, Email N/Meeting N citations, separate date, canQuote, enrichment. Limits: 500 UTF-8 bytes, 4 passages; signed-in member or unrestricted key; read-only keys/viewers get no extraction; write callers queue extraction. Español: muéstrame el correo, busca fuentes.

search_sources

Find saved skills, playbooks, SOPs and saved agent instructions by words and meaning. Use when asked "how do we" only with skill/playbook/SOP words. Do not use for plain process questions → search_knowledge. Inputs: optional query, limit, sortBy, cursor. Outputs: names, descriptions, versions, mode, hasMore, nextCursor; read with get_skill. Limits: 20 maximum; name/description/body, not files; blank lists skills including built-ins; company-brain, brain-skills On. Español: habilidades, playbooks, SOPs.

search_skills

Change the capture bot. Use when recording on the user's explicit request; confirm details first. Do not use for reading → get_meeting_transcript. Inputs: event address, on/off/join_now. Outputs: completed/pending status, event address when known, optional webUrl. Limits: own manageable event; viewers refused; write key and Personal access; capture controls apply. Español: graba la reunión, no grabes la junta, envía el bot ahora.

set_meeting_recording

Attach or detach a project meeting. Use when the user requests a link change. Do not use for calendar edits → update_meeting; details → get_project. Inputs: project, meeting/calendar-event address, attached, mode. Outputs: ok, changed, link. Limits: project member, meetings:write, write key, key project/target access; calendar needs Personal access; Projects controls On; attaching can queue a summary; no external writes. Español: vincula reunión al proyecto, quita reunión del proyecto.

set_project_meetings

End this account's Nysa sign-in for this OAuth client. Use when the user asks to sign out, log out or switch workspace. Do not use for API key revocation or other people's access. Inputs: none. Outputs: signedOut. Limits: OAuth only; ends this client's grant across its sessions; other clients stay connected; billing or an unknown client can refuse; sign in again to pick a workspace. Español: cerrar sesión, cambiar de espacio de trabajo.

sign_out

Start an upload. Use when importing a gbrain, GitHub repo or memory folder. Do not use for a single piece of company information → remember; private working notes → save_note; facts you saved with remember → forget; existing upload → import_status. Inputs: format gbrain/markdown. Outputs: import_id, link. Limits: 100 MiB ZIP, 50,000 files, 400 MiB expanded, 256 KiB/page; unchanged local/repo/server files, no Drive/Dropbox/web; write key, note-writer permission, brain-import On; preview before confirm_import. Español: importa mi gbrain, trae mi memoria.

start_import

Change a meeting you organize. Use when editing on the user's explicit request; confirm details first. Do not use for reading → get_calendar_event. Inputs: event address, title, start/end, time zone, emails, description. Outputs: completed/pending status, event address when known, optional webUrl. Limits: organizer only; viewers refused; write key and Personal access; one occurrence; time/zone changes need both start and end. Español: cambia la reunión, reprograma la junta.

update_meeting

Set how you want agents to work with you: preferences and style. Replaces your whole preference document. Use when saving preferences or aliases; read get_my_memory first. Do not use for team facts → remember; your plans/ideas/progress → save_note. Inputs: full markdown, expectedRevision. Outputs: saved markdown, revision. Limits: 16 KiB; partial text deletes the rest; self-only; personal-memory-use On; directory:write, write key; limited keys need the owner's Personal scope. Español: actualiza mi memoria.

update_my_memory