# MCP tools

Every tool `akou mcp` lists, with its parameters and the annotations a harness reads to decide which tools it may run without asking. The server answers from the local API, so each tool does what the matching command or route does. `akou_ask` is listed only while akou's provider can answer, and never to a client that is itself that provider's harness. The page is generated from the server's tool list, and CI fails when it differs.

## akou\_add\_note

**Add a note**

Add a line to the live call's notepad, marked as written by you.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | `string` | yes | The note, one line, such as "Ben ships the fix Friday". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The note, one line, such as \"Ben ships the fix Friday\"."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_answer

**Answer the ask box**

Post your answer to a question the user typed in akou's ask box: an `ask` line with `by: "user"` from your `akou events` watch, or one listed in akou\_status `live.unanswered`. Read the call with akou\_context first, answer briefly, cite lines as \[HH:MM Name\], then say the same answer in this conversation. The box shows it under your name. Never answer an ask whose `by` starts with `agent:`. `already_answered` means you did already: that is done. `others` says what else answered; with an answer from a model there, post again only to correct or add to it.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `ask` | `string` | yes | The ask id from the `ask` event, such as "q0007". |
| `text` | `string` | yes | Your answer, with \[HH:MM Name\] citations. |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
| `model` | `string` | no | The model that wrote it, if you know. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "ask": {
      "type": "string",
      "pattern": "^q\\d{4,}$",
      "description": "The ask id from the `ask` event, such as \"q0007\"."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "Your answer, with [HH:MM Name] citations."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    },
    "model": {
      "description": "The model that wrote it, if you know.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "ask",
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_ask

**Ask akou's provider**

Answer with akou's own configured provider. Prefer akou\_context and answer yourself: akou\_ask spawns another agent run on the user's subscription.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: true`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `question` | `string` | yes | The user's question, word for word, such as "what did Ben say about the budget?". |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 1,
      "description": "The user's question, word for word, such as \"what did Ben say about the budget?\"."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_config\_get

**Read the settings**

akou's settings as they are in force, secrets redacted, or one with `key` (`asr.live`). Read-only: changing one is the user's, in the window or with `akou config set`.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | `string` | no | One setting's key, such as "asr.live". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "key": {
      "description": "One setting's key, such as \"asr.live\".",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_context

**Context for a question**

The main tool for answering any question about a call: pass the user's question verbatim and answer from the pack it returns (a few thousand tokens, never the whole transcript). Also returns, as typed fields, the cursor for akou\_read, the call state and memoStale. Cite wall-clock times as \[HH:MM Name\]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when. If the answer is not in the pack, say so and name the time range to fetch.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `question` | `string` | yes | The user's question, word for word, such as "what did Ben say about the budget?". |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
| `budget` | `integer` | no | The pack's size in tokens, 500 to 7000. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 1,
      "description": "The user's question, word for word, such as \"what did Ben say about the budget?\"."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    },
    "budget": {
      "default": 6000,
      "description": "The pack's size in tokens, 500 to 7000.",
      "type": "integer",
      "minimum": 500,
      "maximum": 7000
    }
  },
  "required": [
    "question"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_delete\_note

**Delete a note**

Delete one notepad line, by its id from akou\_get\_notes. Only when the user asks: the line may be theirs.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | The note's id from akou\_get\_notes, such as "n0003". |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The note's id from akou_get_notes, such as \"n0003\"."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_devices

**List microphones and apps**

The microphones, outputs and apps with audio akou can record: an input's `id` is what akou\_start takes as `mic`, an app's `id` what it takes as `call: "app:ID"`. Read-only; opens no device.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_dictation\_get

**Read a dictation**

One past dictation by id: its state, the app it went to, the text inserted and the raw text heard, the language, the engine and its timing. Read-only.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | A dictation's id from akou\_dictation\_list. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "A dictation's id from akou_dictation_list."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_dictation\_list

**List past dictations**

The user's past dictations (text they spoke into other apps with akou's dictation key), newest first: id, time, state, the app it went to, and the text. Read-only. `q` keeps those whose text holds it; page with `cursor`.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | `string` | no | Only dictations whose text holds this, in any case. |
| `limit` | `integer` | no | The most dictations per page, 1 to 100. |
| `cursor` | `string` | no | The nextCursor of the previous page. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "q": {
      "description": "Only dictations whose text holds this, in any case.",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "default": 20,
      "description": "The most dictations per page, 1 to 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "The nextCursor of the previous page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_edit\_note

**Edit a note**

Replace the text of one notepad line, by its id from akou\_get\_notes (`n0003`). The old text stays in the call's log.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | The note's id from akou\_get\_notes, such as "n0003". |
| `text` | `string` | yes | The note's new text. |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The note's id from akou_get_notes, such as \"n0003\"."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The note's new text."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_enhance

**Enhance notes with akou's provider**

Ask akou's own provider to write the enhanced notes for a call (default the latest). Prefer akou\_enhance\_context and write them yourself.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: true`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |
| `template` | `string` | no | The template to follow; omit for the call's own. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "default": "last",
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    },
    "template": {
      "description": "The template to follow; omit for the call's own.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_enhance\_context

**Context for enhanced notes**

What you need to write enhanced notes for a call yourself (default the latest): the template and a pack. Pass the `call` it answers to akou\_enhanced\_put, so the notes land on this call even if another one starts meanwhile.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |
| `template` | `string` | no | The template to follow; omit for the call's own. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "default": "last",
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    },
    "template": {
      "description": "The template to follow; omit for the call's own.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_enhanced\_put

**Save enhanced notes**

Save the enhanced notes you wrote for a call: the `call` akou\_enhance\_context answered (default the latest when saved). Every bullet must end with the segment ids it rests on, like \[\#l000031\]; a bullet without a real citation is dropped. Place the user's own notes by id (`- {n0004}`); they are kept word for word.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | The call id akou\_enhance\_context answered; omit for the latest call at the time of saving. |
| `markdown` | `string` | yes | The notes in Markdown, in the template's sections, each bullet cited. |
| `coversSeq` | `integer` | yes | The `coversSeq` akou\_enhance\_context answered: what the notes were written from. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "description": "The call id akou_enhance_context answered; omit for the latest call at the time of saving.",
      "type": "string",
      "minLength": 1
    },
    "markdown": {
      "type": "string",
      "minLength": 1,
      "description": "The notes in Markdown, in the template's sections, each bullet cited."
    },
    "coversSeq": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The `coversSeq` akou_enhance_context answered: what the notes were written from."
    }
  },
  "required": [
    "markdown",
    "coversSeq"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_export

**Export a call**

Hand a finished call off to the export folder: Markdown with frontmatter (enhanced notes, your raw notes, the transcript), the event log and the audio. Needs export.dir set.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | yes | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    }
  },
  "required": [
    "call"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_finalize

**Run the final pass**

Start the accurate final pass on an ended call (default the latest). It runs on its own; akou\_get\_call with layer `final` reads it once done. `force` runs it again on a call that has one; `model` picks qwen, parakeet, or fusion (several engines, their words combined; slower) for this run only.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |
| `force` | `boolean` | no | Run it again on a call that has a final pass. |
| `model` | `"qwen" or "parakeet" or "fusion"` | no | The engine for this run only; omit for the setting. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "default": "last",
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    },
    "force": {
      "description": "Run it again on a call that has a final pass.",
      "type": "boolean"
    },
    "model": {
      "description": "The engine for this run only; omit for the setting.",
      "type": "string",
      "enum": [
        "qwen",
        "parakeet",
        "fusion"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_forget

**Forget a fact**

Retract a line kept with akou\_remember, by its id.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | The id akou\_remember answered, such as "r0001". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The id akou_remember answered, such as \"r0001\"."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_get\_call

**Read a named call**

A call the user named: its transcript from the start, one page at a time, each line with its segment id. When `nextCursor` is not null, call again with it as `cursor` for the next page, and the same `layer`. To answer a question, akou\_context with `call` is cheaper than reading every page. Cite wall-clock times as \[HH:MM Name\]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | yes | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |
| `layer` | `"best" or "live" or "final"` | no | "best": the final pass where it ran, else live; "live": as heard during the call; "final": only the final pass. |
| `cursor` | `string` | no | The nextCursor of the previous page; leave it out for the first page. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    },
    "layer": {
      "default": "best",
      "description": "\"best\": the final pass where it ran, else live; \"live\": as heard during the call; \"final\": only the final pass.",
      "type": "string",
      "enum": [
        "best",
        "live",
        "final"
      ]
    },
    "cursor": {
      "description": "The nextCursor of the previous page; leave it out for the first page.",
      "type": "string"
    }
  },
  "required": [
    "call"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_get\_notes

**Read the notepad**

The live call's notepad: the user's lines and yours, oldest first. A long notepad comes in pages: pass `nextOffset` as `offset` for the next.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `offset` | `integer` | no | The first note to return: 0, or the `nextOffset` of the page before. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "offset": {
      "default": 0,
      "description": "The first note to return: 0, or the `nextOffset` of the page before.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_job\_delete

**Delete a transcription job**

Delete a transcription job: a queued one is dropped, a running one stopped, and its file and transcript removed for good. Only when the user asks, such as for a wrong upload.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | The job id, such as "job\_1". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The job id, such as \"job_1\"."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_job\_get

**Read a transcription job**

One transcription job by id, waiting up to `wait` seconds for it to end; a done job comes with its transcript in `result`. `format: text` (or srt, vtt) returns the transcript alone, much shorter than the default JSON with every word's times: use it for a long file. Read-only.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | yes | The job id akou\_transcribe or akou\_jobs\_list gave, such as "job\_1". |
| `wait` | `integer` | no | Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call. |
| `format` | `"json" or "text" or "srt" or "vtt"` | no | The transcript's form: "json" (words with times), "text", or "srt" / "vtt" subtitles. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The job id akou_transcribe or akou_jobs_list gave, such as \"job_1\"."
    },
    "wait": {
      "default": 50,
      "description": "Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call.",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    },
    "format": {
      "default": "json",
      "description": "The transcript's form: \"json\" (words with times), \"text\", or \"srt\" / \"vtt\" subtitles.",
      "type": "string",
      "enum": [
        "json",
        "text",
        "srt",
        "vtt"
      ]
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_jobs\_list

**List transcription jobs**

The transcription jobs this key submitted, newest first: id, title, state, preset, model and times, no transcript. `status` keeps one state and `q` the jobs whose title or id holds a text; when `cursor` is not null, pass it back for older jobs. Read-only.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | `"queued" or "running" or "done" or "failed" or "cancelled"` | no | Only jobs in this state. |
| `q` | `string` | no | Only jobs whose title, id or state holds this text, in any case. |
| `limit` | `integer` | no | The most jobs per page, 1 to 200. |
| `cursor` | `integer` | no | The `cursor` of the page before: the jobs older than it. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only jobs in this state.",
      "type": "string",
      "enum": [
        "queued",
        "running",
        "done",
        "failed",
        "cancelled"
      ]
    },
    "q": {
      "description": "Only jobs whose title, id or state holds this text, in any case.",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "default": 20,
      "description": "The most jobs per page, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "cursor": {
      "description": "The `cursor` of the page before: the jobs older than it.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_list\_calls

**List past calls**

Past calls by date, title and state (no content search). History beyond a named call lives in the user's own notes.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace` | `string` | no | Only this workspace's calls. |
| `limit` | `integer` | no | The most calls to return, newest first, 1 to 1000. |
| `failed` | `boolean` | no | Only the calls whose start failed (nothing was recorded), instead of the others. A call whose final pass failed is not one. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "Only this workspace's calls.",
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "default": 20,
      "description": "The most calls to return, newest first, 1 to 1000.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "failed": {
      "description": "Only the calls whose start failed (nothing was recorded), instead of the others. A call whose final pass failed is not one.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_memo\_get

**Read the memo**

The live call's rolling memo and the seq it covers.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_memo\_put

**Write the memo**

Write the rolling memo when akou\_context reports memoStale and no provider writes it: topics, decisions, actions with owner, open questions, people, each with \[HH:MM\]. `coversSeq` is the cursor the memo covers up to.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | `string` | yes | The whole memo, in Markdown, replacing the one before. |
| `coversSeq` | `integer` | yes | The `cursor` of the last akou\_context or akou\_read the memo covers. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The whole memo, in Markdown, replacing the one before."
    },
    "coversSeq": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "The `cursor` of the last akou_context or akou_read the memo covers."
    }
  },
  "required": [
    "text",
    "coversSeq"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_merge\_speakers

**Merge two speakers**

Merge speaker `a` into speaker `b` when both are the same person: `a`'s lines read as `b` from then on. Undo with akou\_unmerge\_speaker.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `a` | `string` | yes | The speaker to merge away, such as "c3". |
| `b` | `string` | yes | The speaker to keep, such as "c2". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "a": {
      "type": "string",
      "minLength": 1,
      "description": "The speaker to merge away, such as \"c3\"."
    },
    "b": {
      "type": "string",
      "minLength": 1,
      "description": "The speaker to keep, such as \"c2\"."
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_mute

**Mute the microphone**

Mute the live call's microphone.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_name\_speaker

**Name a speaker**

Name a speaker the moment the user says who a voice is ("Speaker 2 is Ben"). `speaker` is the id from the transcript: you, c2, c3...

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `speaker` | `string` | yes | A speaker id from the transcript: "you" for the microphone, then "c2", "c3"... |
| `name` | `string` | yes | The person's name as the user says it, such as "Ben". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "speaker": {
      "type": "string",
      "minLength": 1,
      "description": "A speaker id from the transcript: \"you\" for the microphone, then \"c2\", \"c3\"..."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "The person's name as the user says it, such as \"Ben\"."
    }
  },
  "required": [
    "speaker",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_open\_window

**Show the window**

Show akou's window to the user, on a call if one is named (`live`, `last` or an id). With no window (headless), answers a browser address that works once, within a minute.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | Open the window on this call. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "description": "Open the window on this call.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_pause

**Pause recording**

Pause the live call.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_read

**Read new lines**

New committed lines since a cursor (the `cursor` field of akou\_context or an earlier akou\_read), plus the line still being spoken and the next cursor. Use it to follow a call instead of re-reading. Cite wall-clock times as \[HH:MM Name\]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
| `since` | `integer` | no | The `cursor` of the last akou\_context or akou\_read: only lines after it. |
| `lastSeconds` | `integer` | no | Only the lines of the last N seconds, such as 120 for the last two minutes. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    },
    "since": {
      "description": "The `cursor` of the last akou_context or akou_read: only lines after it.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "lastSeconds": {
      "description": "Only the lines of the last N seconds, such as 120 for the last two minutes.",
      "type": "integer",
      "minimum": 1,
      "maximum": 86400
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_remember

**Remember a fact**

Keep a fact you will need in later turns (it comes back in every akou\_context pack, even after your context is compacted).

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | `string` | yes | The fact, in one sentence, such as "Ben owns the deploy". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "The fact, in one sentence, such as \"Ben owns the deploy\"."
    }
  },
  "required": [
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_rename\_call

**Rename a call**

Rename a call, live or saved, when the user gives it a name ("call this the Q3 planning"). `call` is `live` (default), `last` or an id from akou\_list\_calls. Every list and search shows the new title at once.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | A call: "live" (the one recording now), "last", or an id from akou\_list\_calls. |
| `title` | `string` | yes | The new title, such as "Q3 planning". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "default": "live",
      "type": "string",
      "minLength": 1,
      "description": "A call: \"live\" (the one recording now), \"last\", or an id from akou_list_calls."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The new title, such as \"Q3 planning\"."
    }
  },
  "required": [
    "title"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_restart

**Restart capture**

Start a new part in the latest call (after a stop, or to rebuild capture). `force` is needed when its last audio is over an hour old.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `force` | `boolean` | no | Start the new part even when the call's last audio is over an hour old. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "force": {
      "description": "Start the new part even when the call's last audio is over an hour old.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_resume

**Resume recording**

Resume the live call.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_search

**Search a call**

Exact word hits in a call with wall-time citations, for names, numbers and terms. Cite wall-clock times as \[HH:MM Name\]; never present an offset as a time of day; never quote a line marked DRAFT as fact; if the call has ENDED, say so and when.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | `string` | yes | The exact word, name or number to find, such as "Hetzner" or "40k". |
| `call` | `string` | no | Which call: "live" (the one recording now), "last", or a call id. Use the live call unless the user names another one. |
| `k` | `integer` | no | The most hits to return, 1 to 50. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The exact word, name or number to find, such as \"Hetzner\" or \"40k\"."
    },
    "call": {
      "default": "live",
      "description": "Which call: \"live\" (the one recording now), \"last\", or a call id. Use the live call unless the user names another one.",
      "type": "string"
    },
    "k": {
      "default": 6,
      "description": "The most hits to return, 1 to 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_share\_off

**Stop sharing**

Stop sharing a call's live link, or every link when no `call` is named. The people holding the link lose it for good; sharing again makes a new address.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | The call whose link to stop; omit for every link. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "description": "The call whose link to stop; omit for every link.",
      "type": "string",
      "minLength": 1
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_share\_on

**Share a live link**

Start a read-only live link to a call (default the live one), only when the user asks to share it. `notes` shares the notepad too; `expires` turns it off after a while (`2h`). Answers the address to hand over.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: true`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `call` | `string` | no | The call to share; default "live". |
| `notes` | `boolean` | no | Share the notepad too. |
| `expires` | `string` | no | When the link turns off: "call-end", "call-end+2h" (the default), or a duration up to 24 hours like "90m" or "2h". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "call": {
      "description": "The call to share; default \"live\".",
      "type": "string",
      "minLength": 1
    },
    "notes": {
      "description": "Share the notepad too.",
      "type": "boolean"
    },
    "expires": {
      "description": "When the link turns off: \"call-end\", \"call-end+2h\" (the default), or a duration up to 24 hours like \"90m\" or \"2h\".",
      "type": "string",
      "pattern": "^(call-end|call-end\\+2h|\\d{1,4} ?(m|min|h))$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_share\_status

**Live links that are on**

The read-only live links that are on, one per shared call: the call, where it listens, when it expires and how many people watch. The token in each address is cut out (`/s/<token>/`): it is the whole credential, so only akou\_share\_on, which the user asks for, answers it.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_start

**Start recording**

Start recording a call now. Make this the first call when the user wants a call recorded: no status check first. Returns once audio is being written. `vocab` takes call-scoped words known before the call (attendee names, title terms). If a call is already recording, starts nothing and returns that call with `attached: true`: follow it with akou\_context and akou\_read like one you started.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace` | `string` | no | A workspace name, such as "work" or "acme": calls and vocabulary are kept per workspace. |
| `title` | `string` | no | The call's title, such as "Q3 planning"; the invite's title when there is one. |
| `template` | `string` | no | The note template for this call's enhanced notes; omit and akou picks one by title. |
| `call` | `string` | no | What to capture as the call side: "system" (the whole computer), "none", or "app:ID" with an app id from akou\_devices |
| `mic` | `string` | no | The microphone: an input id from akou\_devices, or "none" |
| `vocab` | `string[]` | no | Words known before the call for this call only: attendee names, title terms. |
| `final` | `string` | no | The final pass for this call: "fusion" runs several speech engines after the call and combines their words, slower and more accurate; "qwen" or "parakeet" one model. Omit for the setting |
| `withoutModels` | `boolean` | no | Record audio now and transcribe it later, when the speech models are not downloaded yet. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "workspace": {
      "type": "string",
      "minLength": 1,
      "description": "A workspace name, such as \"work\" or \"acme\": calls and vocabulary are kept per workspace."
    },
    "title": {
      "description": "The call's title, such as \"Q3 planning\"; the invite's title when there is one.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "template": {
      "description": "The note template for this call's enhanced notes; omit and akou picks one by title.",
      "type": "string",
      "minLength": 1
    },
    "call": {
      "description": "What to capture as the call side: \"system\" (the whole computer), \"none\", or \"app:ID\" with an app id from akou_devices",
      "type": "string",
      "pattern": "^(system|none|app:.+)$"
    },
    "mic": {
      "description": "The microphone: an input id from akou_devices, or \"none\"",
      "type": "string"
    },
    "vocab": {
      "description": "Words known before the call for this call only: attendee names, title terms.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "final": {
      "description": "The final pass for this call: \"fusion\" runs several speech engines after the call and combines their words, slower and more accurate; \"qwen\" or \"parakeet\" one model. Omit for the setting",
      "type": "string"
    },
    "withoutModels": {
      "description": "Record audio now and transcribe it later, when the speech models are not downloaded yet.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_status

**Recorder status**

Whether a call is recording, its health, recognizer lag and live model (`live.setup`: parakeet or nemotron, `live.engine`, and `live.review`: the second pass's model and interval, or null), the models and provider in use, and sharing. Read models and provider from here, never from memory. Not needed before akou\_start.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_stop

**Stop recording**

Stop the live call.

Annotations: `readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_template\_get

**Read a note template**

One note template as akou would use it (the user's own file when it replaces the shipped one): read it before writing enhanced notes with akou\_enhanced\_put.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | yes | A note template, such as "standup" or "general": the names akou\_template\_list shows. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "A note template, such as \"standup\" or \"general\": the names akou_template_list shows."
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_template\_list

**List note templates**

The note templates enhanced notes can follow: the shipped ones and the user's own, with each one's sections and title keywords. Read one with akou\_template\_get.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_transcribe

**Transcribe a file on a server**

Transcribe an audio or video file on this machine as a job on the akou server (`AKOU_URL`, server mode): uploads the file once (up to 512 MB) and waits up to `wait` seconds. A job that ends in time comes back done with its transcript in `result`; one still queued or running comes back with its `id` for akou\_job\_get. `task: translate` writes the speech in English instead. A path that is missing, too large, or not an audio or video file is refused and nothing is sent.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: true`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `path` | `string` | yes | The file's absolute path on this machine, such as /Users/me/Downloads/note.m4a. |
| `preset` | `"lite" or "fast" or "best" or "fusion" or "auto"` | no | How much accuracy matters; auto lets the server choose. |
| `language` | `string` | no | The spoken language as an ISO code such as en or es, or auto. |
| `diarize` | `boolean` | no | Label the speakers. |
| `title` | `string` | no | A name for the job in akou\_jobs\_list; default the file's name. |
| `task` | `"transcribe" or "translate"` | no | "translate" writes the speech in English; default "transcribe". |
| `keywords` | `string[]` | no | Up to 24 names and terms the speech holds, so the engine spells them right. |
| `wait` | `integer` | no | Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "The file's absolute path on this machine, such as /Users/me/Downloads/note.m4a."
    },
    "preset": {
      "description": "How much accuracy matters; auto lets the server choose.",
      "type": "string",
      "enum": [
        "lite",
        "fast",
        "best",
        "fusion",
        "auto"
      ]
    },
    "language": {
      "description": "The spoken language as an ISO code such as en or es, or auto.",
      "type": "string"
    },
    "diarize": {
      "description": "Label the speakers.",
      "type": "boolean"
    },
    "title": {
      "description": "A name for the job in akou_jobs_list; default the file's name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "task": {
      "description": "\"translate\" writes the speech in English; default \"transcribe\".",
      "type": "string",
      "enum": [
        "transcribe",
        "translate"
      ]
    },
    "keywords": {
      "description": "Up to 24 names and terms the speech holds, so the engine spells them right.",
      "maxItems": 24,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "wait": {
      "default": 50,
      "description": "Seconds to wait for the job to end, up to 50: a short voice note comes back done in the same call.",
      "type": "integer",
      "minimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "path"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_unmerge\_speaker

**Undo a speaker merge**

Undo a merge: the speaker gets its own label back for later lines.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `speaker` | `string` | yes | The speaker that was merged away. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "speaker": {
      "type": "string",
      "minLength": 1,
      "description": "The speaker that was merged away."
    }
  },
  "required": [
    "speaker"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_unmute

**Unmute the microphone**

Unmute the live call's microphone.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

Parameters: none.

**Input schema**

```
{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_add

**Add a word**

Pass on a word the user stated ("it's Vercel, not versal"), with how it was heard. Scope "call" (the default) works like the user fixing a line: every line of the live call with that heard form reads corrected at once. A name, product or jargon word is also learned into the call's and the workspace's vocabulary with no review; a rewording of common words stays in this call only and goes into the call's Notes as "Fixed: heard -\> term" (so does any word while the live engine takes no word list). `decode: false` only corrects the reading of this call. "workspace" or "global" only writes the vocabulary file. Never add a word you inferred; propose it with akou\_vocab\_propose.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `term` | `string` | yes | The word as it should be written, such as "Vercel". |
| `heard` | `string[]` | no | How the transcript wrote it, such as \["versal"\]. |
| `scope` | `"call" or "workspace" or "global"` | no | "call": fix the live call now and learn the word; "workspace" or "global": only write that vocabulary file. |
| `workspace` | `string` | no | The workspace, with scope "workspace". |
| `decode` | `boolean` | no | false: correct only how this call reads, without biasing recognition. |
| `note` | `string` | no | Why the word is there, for the user reading the file. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "minLength": 1,
      "description": "The word as it should be written, such as \"Vercel\"."
    },
    "heard": {
      "description": "How the transcript wrote it, such as [\"versal\"].",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "scope": {
      "default": "call",
      "description": "\"call\": fix the live call now and learn the word; \"workspace\" or \"global\": only write that vocabulary file.",
      "type": "string",
      "enum": [
        "call",
        "workspace",
        "global"
      ]
    },
    "workspace": {
      "description": "The workspace, with scope \"workspace\".",
      "type": "string",
      "minLength": 1
    },
    "decode": {
      "description": "false: correct only how this call reads, without biasing recognition.",
      "type": "boolean"
    },
    "note": {
      "description": "Why the word is there, for the user reading the file.",
      "type": "string"
    }
  },
  "required": [
    "term"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_approve

**Approve proposed words**

Approve proposed words once the user says yes; they become confirmed entries in the workspace file.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `terms` | `string[]` | yes | The terms, as akou\_vocab\_list shows them. |
| `call` | `string` | no | A call whose proposals these are. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "terms": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "The terms, as akou_vocab_list shows them."
    },
    "call": {
      "description": "A call whose proposals these are.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "terms"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_check

**Check a word**

Whether a word is safe to bias recognition with.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `term` | `string` | yes | The word to check, such as "Kubernetes". |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "minLength": 1,
      "description": "The word to check, such as \"Kubernetes\"."
    }
  },
  "required": [
    "term"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_list

**List the vocabulary**

The vocabulary in force: a call's own words and proposals (with `call`), or the files for a workspace. With `call` and `unconfirmed`, the words to review: the call's open proposals with the lines they rest on, and the workspace's unconfirmed entries. With `dictation`, also the words the user fixed while dictating, each pair at its latest status (proposed, ignored, accepted, rejected). Ask the user before approving any.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `workspace` | `string` | no | The files for this workspace, with the global one. |
| `call` | `string` | no | A call's own words and proposals instead of the files. |
| `unconfirmed` | `boolean` | no | Only the words waiting for the user's yes or no. |
| `dictation` | `boolean` | no | Also the words the user fixed while dictating. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "workspace": {
      "description": "The files for this workspace, with the global one.",
      "type": "string",
      "minLength": 1
    },
    "call": {
      "description": "A call's own words and proposals instead of the files.",
      "type": "string",
      "minLength": 1
    },
    "unconfirmed": {
      "description": "Only the words waiting for the user's yes or no.",
      "type": "boolean"
    },
    "dictation": {
      "description": "Also the words the user fixed while dictating.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_propose

**Propose words**

Propose words you inferred (from an invite, a document, a correction you noticed). A proposal does nothing until the user approves it with akou\_vocab\_approve. With `call`, they go to that call's workspace.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `entries` | `object[]` | yes | The words to propose, each with how it was heard and why, when known. |
| `call` | `string` | no | Propose into this call's workspace. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "entries": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "term": {
            "type": "string",
            "minLength": 1
          },
          "heard": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "term"
        ]
      },
      "description": "The words to propose, each with how it was heard and why, when known."
    },
    "call": {
      "description": "Propose into this call's workspace.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "entries"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_reject

**Reject proposed words**

Reject proposed words; they are not proposed again.

Annotations: `readOnlyHint: false`, `destructiveHint: false`, `idempotentHint: false`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `terms` | `string[]` | yes | The terms, as akou\_vocab\_list shows them. |
| `call` | `string` | no | A call whose proposals these are. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "terms": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "The terms, as akou_vocab_list shows them."
    },
    "call": {
      "description": "A call whose proposals these are.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "terms"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## akou\_vocab\_suggest

**Suggest words**

Ranked candidate words from a call or a text, to propose to the user with akou\_vocab\_propose. Give `text` or `call`.

Annotations: `readOnlyHint: true`, `openWorldHint: false`.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `text` | `string` | no | A text to mine: an invite, an agenda, a document. |
| `call` | `string` | no | A call to mine instead of a text. |
| `k` | `integer` | no | The most words to return, 1 to 200. |

**Input schema**

```
{
  "type": "object",
  "properties": {
    "text": {
      "description": "A text to mine: an invite, an agenda, a document.",
      "type": "string",
      "minLength": 1
    },
    "call": {
      "description": "A call to mine instead of a text.",
      "type": "string",
      "minLength": 1
    },
    "k": {
      "default": 20,
      "description": "The most words to return, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```
