@skillcdn/console 0.1.10 → 0.1.12

package/docs/specs/cli.md

@@ -23,7 +23,7 @@ The board is a project's ([ADR-0008](../adr/0008-a-workspace-holds-projects-and-
 | `projects` | `GET /api/v1/projects` | one line per project: key, name, what the person is in it, what waits in it |
 | `use <key>` | `GET /api/v1/projects/<key>` | that the directory works in the project from now on; writes `.skillcdn-console.json` |
 | `work` | `GET /api/v1/work` | what is on the person's plate across their projects: the open tasks assigned to them, the sooner due first, each with its project; and the decisions waiting. Needs no project |
-| `tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day\|today\|week\|overdue>]` | `GET .../tasks` with the filters | one line per task: number, state, priority, title, owner, assignee, category, due day, what waits on it |
+| `tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day\|today\|week\|overdue>] [--limit <n>] [--offset <n>]` | `GET .../tasks` with the filters and the page | one line per task: number, state, priority, title, owner, assignee, category, due day, what waits on it; a page at a time |
 | `task <number\|id>` | `GET .../tasks/<ref>`, the decisions about it, the runs on it | the task in full, with its plan and its moments |
 | `task new <title> [--body <markdown>\|--file <path>] [--state <state>] [--priority <priority>] [--category <key>] [--goal <id>] [--starts <day>] [--due <day>] [--assignee <login\|me>] [--parent <number\|id>]` | `POST .../tasks` | the number and the id |
 | `task edit <number\|id> [--title <title>] [--body ...] [the same flags; `none` clears a field]` | `GET .../tasks/<ref>`, then `PATCH .../tasks/<id>` | the task in full, as it is now |
@@ -33,15 +33,15 @@ The board is a project's ([ADR-0008](../adr/0008-a-workspace-holds-projects-and-
 | `goal edit <id> [--title <title>] [--body ...] [--state <state>] [--due <day\|none>]` | `PATCH .../goals/<id>` | the goal in full, as it is now |
 | `categories` | `GET /api/v1/categories` | one line per category: key, name, colour |
 | `skills` | `GET .../skills` | the project's skills, or the organization's: each with its description and the URI an agent loads it by through its own SkillCDN connection; or why there are none to show |
-| `take <number\|id> [--agent <name>]` | `GET .../tasks/<ref>`, then `POST .../runs` | the run that began, the task in full, and what to do next |
+| `take <number\|id> [--agent <name>]` | `GET .../tasks/<ref>`, then `POST .../runs` | the run that began, the task in full, and what to do next; a run open on the task is taken over ([ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)) |
 | `report <markdown>`, `report --file <path>`, `report -` | `POST .../runs/<id>/reports` | how many reports the run carries |
 | `hand-in <https url \| file path> [--label <words>]` | `POST .../runs/<id>/artifacts` for a link; `POST .../runs/<id>/files` for a file, sent as a form with its name and its media type by extension | how many artifacts |
 | `ask "<question>" --option "<label>" ... [--body <markdown>\|--file <path>] [--wait <seconds>]` | `POST .../decisions` with `runId`, then `GET .../decisions/<id>?wait=` | the decision raised, its options; then the answer, or that it still waits |
 | `decision <id> [--wait <seconds>]` | `GET .../decisions/<id>`, with `?wait=` while waiting | the decision; with a wait, the answer or that it still waits |
-| `decisions [--open]` | `GET .../decisions` | one line per decision |
+| `decisions [--open] [--limit <n>] [--offset <n>]` | `GET .../decisions` | one line per decision; a page at a time |
 | `finish [--summary <markdown>\|--file <path>]`, `fail [...]` | `POST .../runs/<id>/end` | how the run ended |
 | `abandon [<run id>] [--summary <markdown>]` | `POST .../runs/<id>/end`, as `abandoned` | the same |
-| `runs [--task <number\|id>] [--open] [--mine]` | `GET .../runs` | one line per run |
+| `runs [--task <number\|id>] [--open] [--mine] [--limit <n>] [--offset <n>]` | `GET .../runs` | one line per run, with when an open one was last heard from; a page at a time |
 | `run <id>` | `GET .../runs/<id>` | the run in full, with its reports, what it handed in and where each file is read |
 | `decision <id> --outcome <markdown>\|--file <path>` | `PATCH .../decisions/<id>` | the decision as a record, with what followed written down |
 | `docs [<folder>] [--search <words>] [--archived]` | `GET .../docs?folder=` or `?q=` | the folders and the pages of a folder, or the pages found by words: one line per page |
@@ -63,6 +63,8 @@ A project's pages of Markdown ([ADR-0009](../adr/0009-documents-are-pages-of-mar
 
 `report`, `hand-in`, `ask`, `finish` and `fail` act on a run. Named with `--run <id>`, that one; else the one open run begun with this token in the project (`GET .../runs?open=true&mine=true`). None open, or several: the command exits with `1` and says so, listing the open ones, so that an agent working two tasks at once says which.
 
+`tasks`, `decisions` and `runs` show a page at a time: `DEFAULT_PAGE_LIMIT` lines unless `--limit <n>` says otherwise (up to `LIST_LIMIT`), from `--offset <n>` on, and a last line, `... more: --offset <n>`, says how to ask for the next page when there is one; with `--json`, the console's answer as it is, `more` included. An agent reads the first page and asks for the next only when what it looks for is not on it.
+
 ## Waiting for a decision
 
 `ask` waits 60 seconds for the answer unless `--wait` says otherwise, within what an agent's shell gives one command; `decision <id> --wait <seconds>` waits as long as it is told, a day at most. The command asks the console to hold each request for up to 50 seconds (`?wait=`), the server's own bound, and repeats while the time lasts, with a breath between requests; the answer arrives as soon as a person gives it, since the console is woken through the database's own channel. A decision that still waits when the time is up is exit code `3`: the run waits with it, so the agent keeps waiting with `console decision <id> --wait 100`, within what its shell gives one command, and goes on meanwhile only with work that does not depend on the answer. `ask` prints the decision's id as soon as it is raised, before any waiting, so that a wait cut short loses nothing; with `--json` it prints the decision then, and again with its answer when that comes.
@@ -73,7 +75,7 @@ A project's pages of Markdown ([ADR-0009](../adr/0009-documents-are-pages-of-mar
 
 ## Output and exit codes
 
-Plain text on standard output: one line per thing in a list, a few lines for one thing in full, with ids given, since the commands take them, and the vocabulary's own words (`in_progress`, `waiting`), since the options take them. What went wrong goes to standard error as the console's stable code and its words (`run.task_taken: an agent is at work on the task already`), with a hint when there is something to do about it.
+Plain text on standard output: one line per thing in a list, a few lines for one thing in full, with ids given, since the commands take them, and the vocabulary's own words (`in_progress`, `waiting`), since the options take them. What went wrong goes to standard error as the console's stable code and its words (`run.task_closed: the task is done or dropped`), with a hint when there is something to do about it.
 
 | Exit code | Meaning |
 |---|---|

package/docs/specs/rest.md

@@ -20,6 +20,8 @@ The API is the board as its members see it: the people, the projects, and in eac
 |---|---|---|
 | 400 | `request.invalid` | A query parameter or the body does not parse; the message names the first field at fault. |
 | 400 | `project.invalid_address` | The skills address is not one, as the standard spells them. |
+| 400 | `project.invalid_icon` | The image for the mark is not a PNG, a JPEG, a GIF or a WebP, by its first bytes. |
+| 404 | `project.no_icon` | The project has no image for its mark. |
 | 400 | `member.invalid_person` | The person to list is not one of the workspace. |
 | 400 | `task.invalid_assignee` | The assignee is not a person who may work in the project. |
 | 400 | `task.invalid_parent` | The parent is not a task of the project, is the task itself, or would make a loop. |
@@ -55,7 +57,7 @@ The API is the board as its members see it: the people, the projects, and in eac
 | 409 | `connect.approved` | The connection was approved already; the command claims its token. |
 | 429 | `connect.too_many` | As many agents ask to connect as the console holds at once; try again in a few minutes. |
 | 409 | `person.last_admin` | The change would leave the board without an administrator. |
-| 409 | `run.over`, `run.task_taken`, `run.task_closed` | The run has ended already; an agent is at work on the task already; the task is done or dropped. |
+| 409 | `run.over`, `run.task_closed` | The run has ended already; the task is done or dropped. A run open on a task is no refusal: a new run takes it over ([ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)). |
 | 413 | `request.too_large` | The body is over the limit; for a file handed in or attached, the file is over `MAX_FILE_BYTES`. |
 | 503 | `file.store_unavailable` | The bytes of files are kept in a bucket, and it did not answer or refused the console; `retry-after` says when to try again. Nothing was written on the run or the page. |
 
@@ -75,11 +77,11 @@ Takes `role` and answers the person. For an administrator signed in on the conso
 
 ### `GET /api/v1/projects`
 
-`{ "items": [project, ...] }`: the projects the asker may see, by name. A project carries its `key` (what paths and the command say; lowercase letters, digits and hyphens; immutable), `name`, `description`, `visibility` (`workspace`: everyone of the workspace is a member; `private`: only those listed), `skillsAddress` (canonical, or `null` for the organization's), `role` (what the asker is in it: `owner`, who configures it, or `member`, who works in it), `openDecisions` and `openRuns` (what waits in it), `createdAt` and `updatedAt`. A workspace administrator sees every project, as its owner; a member sees those open to the workspace, as a member, and those they are listed in, as what they are listed.
+`{ "items": [project, ...] }`: the projects the asker may see, by name. A project carries its `key` (what paths and the command say; lowercase letters, digits and hyphens; immutable), `name`, `description`, `visibility` (`workspace`: everyone of the workspace is a member; `private`: only those listed), `skillsAddress` (canonical, or `null` for the organization's), its mark, `color` (one of `COLOR_NAMES`, or `null`) and `symbol` (up to `MAX_PROJECT_SYMBOL_LENGTH` characters with no whitespace, or `null`; where either is `null` the pages choose one from the key and the name, `projectColorOf` and `projectSymbolOf`, so that projects are told apart either way), `icon` (the project's own image for its mark, shown in place of the symbol: its `sha256` and its `contentType`, one of `PROJECT_ICON_TYPES`; or `null`), `role` (what the asker is in it: `owner`, who configures it, or `member`, who works in it), `openDecisions` (the decisions waiting in it) and `openRuns` (the runs open in it: begun and not ended, which says nothing of whether an agent is still at them, [ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), `createdAt` and `updatedAt`. A workspace administrator sees every project, as its owner; a member sees those open to the workspace, as a member, and those they are listed in, as what they are listed.
 
 ### `POST /api/v1/projects`
 
-Takes `key` and `name`, and optionally `description`, `visibility` (default `private`) and `skillsAddress` (checked as the standard spells one, kept canonical; `project.invalid_address`). For whoever is signed in on the console's own pages, never with a token; they become the project's owner. Answers `201` with the project and writes a `project.created` event in it, with `key` and `name`. A key taken is `project.key_taken`.
+Takes `key` and `name`, and optionally `description`, `visibility` (default `private`), `skillsAddress` (checked as the standard spells one, kept canonical; `project.invalid_address`), `color` and `symbol`. For whoever is signed in on the console's own pages, never with a token; they become the project's owner. Answers `201` with the project and writes a `project.created` event in it, with `key` and `name`. A key taken is `project.key_taken`.
 
 ### `GET /api/v1/events?after=&limit=`
 
@@ -99,7 +101,7 @@ Kept by an administrator signed in on the console's own pages, never with a toke
 
 ### `GET /api/v1/work`
 
-`{ "tasks": [{ "project": { "key", "name" }, "task" }, ...], "decisions": [{ "project", "decision" }, ...] }`: what is on the asker's plate across the projects they may see ([ADR-0019](../adr/0019-a-task-is-planned-in-days-the-board-keeps-its-moments-and-goals-and-categories-give-the-work-its-shape.md)): the open tasks assigned to them, the sooner due first and those with no day last, and the decisions that wait for a person, the longest waiting first; each with the project it belongs to, so that a page says and links it. At most `LIST_LIMIT` of each.
+`{ "tasks": [{ "project": { "key", "name", "color", "symbol", "icon" }, "task" }, ...], "decisions": [{ "project", "decision" }, ...] }`: what is on the asker's plate across the projects they may see ([ADR-0019](../adr/0019-a-task-is-planned-in-days-the-board-keeps-its-moments-and-goals-and-categories-give-the-work-its-shape.md)): the open tasks assigned to them, the sooner due first and those with no day last, and the decisions that wait for a person, the longest waiting first; each with the project it belongs to, so that a page says and links it. At most `LIST_LIMIT` of each.
 
 ### `GET /api/v1/tokens` and `POST /api/v1/tokens`
 
@@ -129,7 +131,11 @@ Everything below is under `/api/v1/projects/<key>`, for whoever may see the proj
 
 ### `GET /api/v1/projects/<key>` and `PATCH /api/v1/projects/<key>`
 
-The project, as the asker sees it. A patch, for an owner signed in, takes any of `name`, `description`, `visibility` and `skillsAddress` (`null` for the organization's), and writes a `project.updated` event naming the `fields`; what is already so writes nothing. The key does not change.
+The project, as the asker sees it. A patch, for an owner signed in, takes any of `name`, `description`, `visibility`, `skillsAddress` (`null` for the organization's), `color` and `symbol` (`null` for none), and writes a `project.updated` event naming the `fields`; what is already so writes nothing. The key does not change.
+
+### `POST /api/v1/projects/<key>/icon`, `DELETE .../icon` and `GET .../icon`
+
+The project's own image for its mark, in place of the symbol on the colour. `POST`, for an owner signed in on the console's own pages, takes a form with a part called `file`: a PNG, a JPEG, a GIF or a WebP of at most `MAX_PROJECT_ICON_BYTES`, known by its first bytes and never by what the form says of it (`project.invalid_icon`; `request.too_large`). The bytes are kept by their hash, the project is answered with its `icon`, and the board hears `project.updated` with `fields: ["icon"]`; the same image again writes nothing. `DELETE` takes the image away and answers the project. `GET`, for whoever may see the project, answers the bytes with their type, the hash as `ETag` and `Cache-Control: private, max-age=86400`, or `304` to a matching `If-None-Match`; a project without an image is `project.no_icon`. The pages read it at `projectIconPath(key, icon)`, which carries the hash as a version.
 
 ### `GET /api/v1/projects/<key>/members` and `POST /api/v1/projects/<key>/members`
 
@@ -139,9 +145,9 @@ The project, as the asker sees it. A patch, for an owner signed in, takes any of
 
 For an owner signed in. The patch takes `role` and writes `project.member_changed`; the removal answers `204` and writes `project.member_removed`. A person not listed is `member.not_found`. A project may be left without an owner listed; the administrators own it then.
 
-### `GET /api/v1/projects/<key>/tasks?state=&open=&category=&goal=&assignee=&dueBy=`
+### `GET /api/v1/projects/<key>/tasks?state=&open=&category=&goal=&assignee=&dueBy=&limit=&offset=`
 
-`{ "items": [task, ...] }`: the project's board, newest first, at most `LIST_LIMIT` tasks. `state` keeps one state of it; `open=true` the tasks not done or dropped, `open=false` the rest; `category=<key>` those sorted into a category; `goal=<id>` those that work towards a goal; `assignee=<person id>` those assigned to one person; `dueBy=<day>` (`2026-10-24`) those due on that day or before it. A task carries its `number` (the one people say out loud, numbered per project), `title`, `body` (Markdown, to be shown as text or rendered to elements, never as HTML), `state`, `priority`, `owner`, `assignee` (a person, or `null`), `parentId`, `category` (its `key`, `name` and `color` as the workspace keeps it, or `null`), `goalId` (or `null`), its plan ([ADR-0019](../adr/0019-a-task-is-planned-in-days-the-board-keeps-its-moments-and-goals-and-categories-give-the-work-its-shape.md)): `startsOn` and `dueOn`, each a day (`2026-10-24`) or `null`; its moments, which the board keeps itself: `startedAt`, when it was first moved past `ready`, and `doneAt`, when it was moved to `done`, each an instant or `null`; `links` (`url` and `label`), `openDecisions` (how many decisions about it wait for a person), `openRuns` (how many agents are at work on it, or waiting), `createdAt` and `updatedAt`.
+`{ "items": [task, ...], "more": boolean }`: the project's board, newest first, a page at a time: `limit` (1 to `LIST_LIMIT`, the default) and `offset` (from 0) say which page, and `more` whether there is one after it; a `limit` or an `offset` that is not a number in range is `request.invalid`. `state` keeps one state of it; `open=true` the tasks not done or dropped, `open=false` the rest; `category=<key>` those sorted into a category; `goal=<id>` those that work towards a goal; `assignee=<person id>` those assigned to one person; `dueBy=<day>` (`2026-10-24`) those due on that day or before it. A task carries its `number` (the one people say out loud, numbered per project), `title`, `body` (Markdown, to be shown as text or rendered to elements, never as HTML), `state`, `priority`, `owner`, `assignee` (a person, or `null`), `parentId`, `category` (its `key`, `name` and `color` as the workspace keeps it, or `null`), `goalId` (or `null`), its plan ([ADR-0019](../adr/0019-a-task-is-planned-in-days-the-board-keeps-its-moments-and-goals-and-categories-give-the-work-its-shape.md)): `startsOn` and `dueOn`, each a day (`2026-10-24`) or `null`; its moments, which the board keeps itself: `startedAt`, when it was first moved past `ready`, and `doneAt`, when it was moved to `done`, each an instant or `null`; `links` (`url` and `label`), `openDecisions` (how many decisions about it wait for a person), `openRuns` (how many runs on it are open: begun and not ended, which says nothing of whether an agent is still at it, [ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), `createdAt` and `updatedAt`.
 
 ### `POST /api/v1/projects/<key>/tasks`
 
@@ -151,9 +157,9 @@ Takes `title`, and optionally `body`, `state` (default `idea`), `priority` (defa
 
 One task, by its id or by its number in the project (`/tasks/7`): the pages hold ids, people and their agents say numbers. A patch takes the id and names only what changes, with the same fields as a creation; a field set to `null` clears it. A change of `state` is a `task.moved` event with `from` and `to`; any other change is one `task.updated` event naming the `fields` (`category`, `goalId`, `startsOn` and `dueOn` among them, as the input names them). A patch that changes nothing writes nothing and answers the task as it is. The moments follow the moves: the first move past `ready` sets `startedAt`, a move to `done` sets `doneAt`, and a move back out of `done` clears it.
 
-### `GET /api/v1/projects/<key>/decisions?open=&task=`
+### `GET /api/v1/projects/<key>/decisions?open=&task=&limit=&offset=`
 
-`{ "items": [decision, ...] }`: the project's, the ones that wait first, newest first within each; `open=true` keeps only those that wait, `task=<id>` only those about one task. A decision carries its `question`, `body` (Markdown: the context it rests on), `options` (each an `id` and a `label`), `taskId` and `taskNumber` (or `null`), `raisedBy`, `run` (the `id` and `agent` of the run that raised it, when an agent asked, or `null`), `answer`: `null` while it waits, else the chosen `option`, a `note` or `null` (the rationale given with it), `by` and `at`; and `outcome`, what followed, in Markdown, or `null` until someone writes it. Context, rationale and outcome make the decision a record ([ADR-0009](../adr/0009-documents-are-pages-of-markdown-in-a-project-addressed-by-path-versioned-and-linked-both-ways.md)); a link in any of them to a document's path is kept both ways, so that the document says the decision refers to it.
+`{ "items": [decision, ...], "more": boolean }`: the project's, the ones that wait first, newest first within each, a page at a time as the tasks are (`limit`, `offset`, `more`); `open=true` keeps only those that wait, `task=<id>` only those about one task. A decision carries its `question`, `body` (Markdown: the context it rests on), `options` (each an `id` and a `label`), `taskId` and `taskNumber` (or `null`), `raisedBy`, `run` (the `id` and `agent` of the run that raised it, when an agent asked, or `null`), `answer`: `null` while it waits, else the chosen `option`, a `note` or `null` (the rationale given with it), `by` and `at`; and `outcome`, what followed, in Markdown, or `null` until someone writes it. Context, rationale and outcome make the decision a record ([ADR-0009](../adr/0009-documents-are-pages-of-markdown-in-a-project-addressed-by-path-versioned-and-linked-both-ways.md)); a link in any of them to a document's path is kept both ways, so that the document says the decision refers to it.
 
 ### `POST /api/v1/projects/<key>/decisions`
 
@@ -177,13 +183,13 @@ The roadmap ([ADR-0019](../adr/0019-a-task-is-planned-in-days-the-board-keeps-it
 
 One goal, for whoever may see the project. The patch, for an owner, takes any of `title`, `body`, `state` and `dueOn` (`null` for none), answers the goal and writes `goal.updated` naming the `fields`; a patch that changes nothing writes nothing. A goal is never deleted: one let go is `dropped`. A task works towards a goal through its `goalId`; the goal's events are read from the project's feed with `goal=<id>`.
 
-### `GET /api/v1/projects/<key>/runs?task=&open=&mine=` and `GET .../runs/<id>`
+### `GET /api/v1/projects/<key>/runs?task=&open=&mine=&limit=&offset=` and `GET .../runs/<id>`
 
-`{ "items": [run, ...] }`: the project's runs, newest first, at most `LIST_LIMIT`; `task=<id>` keeps those on one task, `open=true` those not over (`running` or `waiting`) and `open=false` those over, `mine=true` the asker's own: with a token, the runs begun with that token, which is one agent's; on a session, the runs for the person. A run is one agent at work on one task for one person: `taskId` and `taskNumber` (the one people say), `person` (whom the agent acts for), `agent` (what it calls itself), `status` (`running`, `waiting` for a decision, `finished`, `failed`, `abandoned`), `startedAt`, `endedAt` or `null`, `summary` (Markdown, what the agent said at the end, or `null`), `reports` (each `id`, `body` in Markdown, `createdAt`; oldest first), `artifacts` (each `id`, `kind`, `url` for a link or `null`, `label` or `null`, `file` for a file or `null`, and `createdAt`; a file is its `name`, `size` in bytes, `contentType` and `sha256`), and `waitingFor`, the id of the decision the run waits for, or `null`.
+`{ "items": [run, ...], "more": boolean }`: the project's runs, newest first, a page at a time as the tasks are (`limit`, `offset`, `more`); `task=<id>` keeps those on one task, `open=true` those not over (`running` or `waiting`) and `open=false` those over, `mine=true` the asker's own: with a token, the runs begun with that token, which is one agent's; on a session, the runs for the person. A run is one agent's work on one task for one person: `taskId` and `taskNumber` (the one people say), `person` (whom the agent acts for), `agent` (what it calls itself), `status` (`running`, that is open, `waiting` for a decision, `finished`, `failed`, `abandoned`), `startedAt`, `endedAt` or `null`, `lastHeardAt` (when the agent was last heard from through the run: its start, then its latest report, hand-in or question; the console knows nothing of an agent but what it sends, and claims nothing more, [ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), `summary` (Markdown, what the agent said at the end, or `null`), `reports` (each `id`, `body` in Markdown, `createdAt`; oldest first), `artifacts` (each `id`, `kind`, `url` for a link or `null`, `label` or `null`, `file` for a file or `null`, and `createdAt`; a file is its `name`, `size` in bytes, `contentType` and `sha256`), and `waitingFor`, the id of the decision the run waits for, or `null`.
 
 ### `POST /api/v1/projects/<key>/runs`
 
-Takes `taskId` (a task of the project; `run.task_not_found` otherwise), and optionally `agent` (what people see at work, `MAX_AGENT_LENGTH`; left out, the name of the token presented, or the person's login on a session). The run begins: the task becomes the asker's and `in_progress`, and the board is told (`run.started`). One agent at a time per task (`run.task_taken`); a task that is `done` or `dropped` cannot be taken (`run.task_closed`). Answers `201` with the run, whose `id` the rest take.
+Takes `taskId` (a task of the project; `run.task_not_found` otherwise), and optionally `agent` (what people see on the run, `MAX_AGENT_LENGTH`; left out, the name of the token presented, or the person's login on a session). The run begins: the task becomes the asker's and `in_progress`, and the board is told (`run.started`). A run open on the task is taken over ([ADR-0020](../adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)): it ends as `abandoned`, with a summary that says who took over, and the board is told (`run.taken_over`, by the one who took over, with the `agent` that was at it), since the console cannot tell a run still at work from one whose agent is gone. A task that is `done` or `dropped` cannot be taken (`run.task_closed`). Answers `201` with the run, whose `id` the rest take.
 
 ### `POST .../runs/<id>/reports` and `POST .../runs/<id>/artifacts`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillcdn/console",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "What a custom SkillCDN console is built from: the API client and schemas, the components, the composition of the default console, and the console command agents work the board with.",
   "license": "MIT",
   "homepage": "https://github.com/skillcdn/console#readme",

package/skills/building-a-console/SKILL.md

@@ -66,11 +66,11 @@ Produces the **plan** and the first build. Install first, in the new folder, so
 
 ### Phase 2: Configure before replacing
 
-Produces the **configuration**. `createConsole(config)` takes `title`; `brand`, the addresses of a symbol and a wordmark; `languages`, the packs the pages speak, where a language of one's own is `src/i18n/en.ts` copied whole and translated; `components`, the pieces to replace, with the props `ConsoleComponents` names; `baseUrl`, the API's origin, the page's own when left out; and `client`, for tests. A console with marks of its own imports their files in `main.tsx`, so that the build takes them as assets, and passes their addresses through `brand`; `build: { assetsInlineLimit: 0 }` in `vite.config.ts` keeps every picture and font a file, since the policy allows a small picture inlined as a `data:` address but no `data:` font, and the default console only happens to have none small enough; sets `index.html`'s `<title>`, its `lang` and its icons, the mark as `favicon.svg` linked directly, with an `.ico` and a touch icon when the person has them (the default console links three from its brand package through a small build plugin); and loads the faces its languages need. Most wants are configuration or the styles: re-skinning starts and mostly ends with the tokens of `console.css` (the colours, the glass, the field), overridden by a stylesheet of the console's own loaded after the package's, with the mapping of the plan. Replace a component only when configuration cannot do it: start from its source under `src/components/`, keep its props, and keep or add `sc-` classes. With the look in place, show the pages and stop for the look checkpoint.
+Produces the **configuration**. `createConsole(config)` takes `title`; `brand`, the addresses of a symbol and a wordmark; `languages`, the packs the pages speak, where a language of one's own is `src/i18n/en.ts` copied whole and translated; `components`, the pieces to replace, with the props `ConsoleComponents` names; `pages`, tabs of the console's own, each a `CustomPage` with a key, a label by language, a level (the workspace's pages or every project's) and `render`, given the data, the client, the navigation and the words; `baseUrl`, the API's origin, the page's own when left out; and `client`, for tests. The look is the stylesheet's tokens, `--sc-*` on `:root`, set in a stylesheet of the console's own loaded after `console.css`, and the blocks are styled by their `sc-` classes; the package's README lists the tokens by group. A console with marks of its own imports their files in `main.tsx`, so that the build takes them as assets, and passes their addresses through `brand`; `build: { assetsInlineLimit: 0 }` in `vite.config.ts` keeps every picture and font a file, since the policy allows a small picture inlined as a `data:` address but no `data:` font, and the default console only happens to have none small enough; sets `index.html`'s `<title>`, its `lang` and its icons, the mark as `favicon.svg` linked directly, with an `.ico` and a touch icon when the person has them (the default console links three from its brand package through a small build plugin); and loads the faces its languages need. Most wants are configuration or the styles: re-skinning starts and mostly ends with the tokens of `console.css` (the colours, the glass, the field), overridden by a stylesheet of the console's own loaded after the package's, with the mapping of the plan. Replace a component only when configuration cannot do it: start from its source under `src/components/`, keep its props, and keep or add `sc-` classes. With the look in place, show the pages and stop for the look checkpoint.
 
 ### Phase 3: Compose pages of one's own
 
-Produces the **pages**. For a page the default console lacks: `useConsoleData(client, projectKey)` answers the workspace and the project the page is on, kept current by the project's stream, with the actions; the components take their data as props and nothing from the network; `matchRoute`, `PATHS`, `projectHref`, `taskHref`, `decisionHref` and `docHref` name the addresses; `Shell` is the header with the tabs and the person's menu. A composition of one's own is `src/console.tsx` with pages added or taken away. A request without a page of its own skips this phase.
+Produces the **pages**. For a page the default console lacks: `useConsoleData(client, projectKey)` answers the workspace and the project the page is on, kept current by the project's stream, with the actions; the components take their data as props and nothing from the network; `matchRoute`, `PATHS`, `projectHref`, `taskHref`, `decisionHref` and `docHref` name the addresses; `Shell` is the header with the tabs and the person's menu. A page as a tab is `pages` in the configuration, its `render` composing the components over what it is given; a composition of one's own is `src/console.tsx` with pages added or taken away. A request without a page of its own skips this phase.
 
 ### Phase 4: Run it against the board
 

package/skills/working-the-board/SKILL.md

@@ -47,7 +47,7 @@ Each phase ends with something on the board. Only phase 4 waits for a person.
 
 ### Phase 1: Read
 
-`console task <number>` shows the task in full, with its plan, the decisions about it and the runs on it. A run open on it by another agent means the task is taken: say so and stop. A task that is past its due day is still the task; the first report says so, and what the day was for is kept in mind. Read what the body links to, with `console doc <path>` for the project's pages and `console skills` for the organization's skills, before anything is made.
+`console task <number>` shows the task in full, with its plan, the decisions about it and the runs on it. A run open on it means another agent was at it, and may still be: the console cannot tell ([ADR-0020](/docs/adr/0020-the-console-does-not-claim-an-agent-is-at-work-a-run-says-when-it-was-last-heard-from-and-a-new-run-takes-over.md)), so read its reports and when it was last heard from, and take the task only when the person said to, since taking it ends that run as taken over; otherwise say so and stop. A task that is past its due day is still the task; the first report says so, and what the day was for is kept in mind. Read what the body links to, with `console doc <path>` for the project's pages and `console skills` for the organization's skills, before anything is made.
 
 ### Phase 2: Take
 

package/src/api.ts

@@ -12,6 +12,7 @@ export {
   type EventFilter,
   type FetchLike,
   type FileUpload,
+  type Page,
   type ProjectClient,
   type TaskFilter,
 } from "./client.js";
@@ -31,6 +32,7 @@ export {
   nameOf,
 } from "./documents.js";
 export {
+  DEFAULT_PAGE_LIMIT,
   DEFAULT_TOKEN_DAYS,
   EVENTS_PAGE_LIMIT,
   LIST_LIMIT,
@@ -53,8 +55,10 @@ export {
   MAX_OPTION_LABEL_LENGTH,
   MAX_OPTIONS,
   MAX_PROJECT_DESCRIPTION_LENGTH,
+  MAX_PROJECT_ICON_BYTES,
   MAX_PROJECT_KEY_LENGTH,
   MAX_PROJECT_NAME_LENGTH,
+  MAX_PROJECT_SYMBOL_LENGTH,
   MAX_QUESTION_LENGTH,
   MAX_REPORTS_PER_RUN,
   MAX_SEARCH_LENGTH,
@@ -69,6 +73,7 @@ export {
   MAX_VERSIONS_PER_DOCUMENT,
   MIN_OPTIONS,
 } from "./limits.js";
+export { projectColorOf, projectSymbolOf } from "./marks.js";
 export {
   AUTH_ROUTES,
   CLAIM_PATH,
@@ -79,6 +84,7 @@ export {
   PROJECT_COLLECTIONS,
   type ProjectCollection,
   personTokensPath,
+  projectIconPath,
   projectPath,
   REST_ROUTES,
   RETURN_TO_PARAM,
@@ -133,6 +139,7 @@ export {
   type RestPerson,
   type RestPersonPatch,
   type RestProject,
+  type RestProjectIcon,
   type RestProjectInput,
   type RestProjectPatch,
   type RestProjects,
@@ -202,6 +209,7 @@ export {
   restPeopleSchema,
   restPersonPatchSchema,
   restPersonSchema,
+  restProjectIconSchema,
   restProjectInputSchema,
   restProjectPatchSchema,
   restProjectSchema,
@@ -236,6 +244,8 @@ export {
   type ArtifactKind,
   CATEGORY_COLORS,
   type CategoryColor,
+  COLOR_NAMES,
+  type ColorName,
   EVENT_KINDS,
   type EventKind,
   GOAL_STATES,
@@ -246,9 +256,11 @@ export {
   OPEN_TASK_STATES,
   PERSON_ROLES,
   type PersonRole,
+  PROJECT_ICON_TYPES,
   PROJECT_ROLES,
   PROJECT_VISIBILITIES,
   PROVIDER_KEYS,
+  type ProjectIconType,
   type ProjectRole,
   type ProjectVisibility,
   type ProviderKey,

package/src/cli/cli.ts

@@ -8,7 +8,7 @@ import {
   type ProjectClient,
 } from "../client.js";
 import { addDays, dayOf as dayOfDate, isDay } from "../dates.js";
-import { MAX_OPTIONS, MIN_OPTIONS } from "../limits.js";
+import { DEFAULT_PAGE_LIMIT, LIST_LIMIT, MAX_OPTIONS, MIN_OPTIONS } from "../limits.js";
 import type { RestClaim, RestDecision, RestTaskPatch } from "../schemas.js";
 import {
   GOAL_STATES,
@@ -30,6 +30,7 @@ import {
   formatDocuments,
   formatGoal,
   formatGoalLine,
+  formatMore,
   formatOptions,
   formatProjectLine,
   formatRun,
@@ -351,6 +352,26 @@ function secondsOf(value: string | undefined, fallback: number): number {
   return seconds;
 }
 
+/** The flags of a page of a listing: how many, from which one on. */
+const PAGE_OPTIONS: OptionSpec = { limit: { type: "string" }, offset: { type: "string" } };
+
+/** The page the flags ask for: `DEFAULT_PAGE_LIMIT` items from the first when nothing is said. */
+function pageOf(values: Values): { readonly limit: number; readonly offset: number } {
+  const limit = text(values, "limit");
+  const offset = text(values, "offset");
+  const page = {
+    limit: limit === undefined ? DEFAULT_PAGE_LIMIT : Number(limit),
+    offset: offset === undefined ? 0 : Number(offset),
+  };
+  if (!Number.isInteger(page.limit) || page.limit < 1 || page.limit > LIST_LIMIT) {
+    throw misuse(`Not a number of items, 1 to ${LIST_LIMIT}: ${limit}`);
+  }
+  if (!Number.isInteger(page.offset) || page.offset < 0) {
+    throw misuse(`Not a number of items to skip: ${offset}`);
+  }
+  return page;
+}
+
 /** One positional, and nothing else. */
 function theOne(positionals: readonly string[], ask: string): string {
   const [first] = positionals;
@@ -546,10 +567,12 @@ const tasks: Command = async (args, io) => {
       category: { type: "string" },
       goal: { type: "string" },
       due: { type: "string" },
+      ...PAGE_OPTIONS,
     },
     false,
   );
   const state = stateOf(text(values, "state"));
+  const page = pageOf(values);
   const session = await open(io, values);
   const project = await session.project();
   // What is due: a day, or the words for the usual windows; overdue keeps only the open ones.
@@ -573,9 +596,13 @@ const tasks: Command = async (args, io) => {
     ...(text(values, "category") === undefined ? {} : { category: text(values, "category") }),
     ...(text(values, "goal") === undefined ? {} : { goal: text(values, "goal") }),
     ...(dueBy === undefined ? {} : { dueBy }),
+    ...page,
   });
   answer(io, session, found, () =>
-    found.items.length === 0 ? "No tasks." : found.items.map(formatTaskLine).join("\n"),
+    found.items.length === 0
+      ? "No tasks."
+      : found.items.map(formatTaskLine).join("\n") +
+        formatMore(found.more, page.limit, page.offset),
   );
   return EXIT.ok;
 };
@@ -734,7 +761,7 @@ const take: Command = async (args, io) => {
   });
   answer(io, session, { run, task: found }, () =>
     [
-      `Run ${run.id} began on #${found.number} ${found.title}, as "${run.agent}" for ${run.person.login}. The task is in progress and theirs.`,
+      `Run ${run.id} began on #${found.number} ${found.title}, as "${run.agent}" for ${run.person.login}. The task is in progress and theirs. A run that was open on it is over now: the board cannot know whether its agent still ran, so taking it was deciding.`,
       "",
       formatTask(found),
       "",
@@ -1154,12 +1181,19 @@ const goal: Command = async (args, io) => {
 };
 
 const decisions: Command = async (args, io) => {
-  const { values } = parse(args, { open: { type: "boolean" } }, false);
+  const { values } = parse(args, { open: { type: "boolean" }, ...PAGE_OPTIONS }, false);
+  const page = pageOf(values);
   const session = await open(io, values);
   const project = await session.project();
-  const found = await project.decisions(on(values, "open") ? { open: true } : {});
+  const found = await project.decisions({
+    ...(on(values, "open") ? { open: true } : {}),
+    ...page,
+  });
   answer(io, session, found, () =>
-    found.items.length === 0 ? "No decisions." : found.items.map(formatDecisionLine).join("\n"),
+    found.items.length === 0
+      ? "No decisions."
+      : found.items.map(formatDecisionLine).join("\n") +
+        formatMore(found.more, page.limit, page.offset),
   );
   return EXIT.ok;
 };
@@ -1212,9 +1246,15 @@ const abandon: Command = async (args, io) => {
 const runs: Command = async (args, io) => {
   const { values } = parse(
     args,
-    { task: { type: "string" }, open: { type: "boolean" }, mine: { type: "boolean" } },
+    {
+      task: { type: "string" },
+      open: { type: "boolean" },
+      mine: { type: "boolean" },
+      ...PAGE_OPTIONS,
+    },
     false,
   );
+  const page = pageOf(values);
   const session = await open(io, values);
   const project = await session.project();
   const ref = text(values, "task");
@@ -1223,9 +1263,12 @@ const runs: Command = async (args, io) => {
     ...(taskId === undefined ? {} : { task: taskId }),
     ...(on(values, "open") ? { open: true } : {}),
     ...(on(values, "mine") ? { mine: true } : {}),
+    ...page,
   });
   answer(io, session, found, () =>
-    found.items.length === 0 ? "No runs." : found.items.map(formatRunLine).join("\n"),
+    found.items.length === 0
+      ? "No runs."
+      : found.items.map(formatRunLine).join("\n") + formatMore(found.more, page.limit, page.offset),
   );
   return EXIT.ok;
 };

package/src/cli/format.ts

@@ -39,12 +39,14 @@ export function formatProjectLine(project: RestProject): string {
   if (project.openDecisions > 0) {
     notes.push(`${plural(project.openDecisions, "decision")} waiting`);
   }
-  if (project.openRuns > 0) {
-    notes.push(`${plural(project.openRuns, "agent")} at work`);
-  }
   return `${project.key}  ${project.name}  (${notes.join("; ")})`;
 }
 
+/** The line under a page of a listing that has more after it: how to ask for the next page. */
+export function formatMore(more: boolean, limit: number, offset: number): string {
+  return more ? `\n... more: --offset ${offset + limit}` : "";
+}
+
 export function formatTaskLine(task: RestTask): string {
   const notes = [`owner ${task.owner.login}`];
   if (task.assignee !== null) {
@@ -59,9 +61,6 @@ export function formatTaskLine(task: RestTask): string {
   if (task.openDecisions > 0) {
     notes.push(`${plural(task.openDecisions, "decision")} waiting`);
   }
-  if (task.openRuns > 0) {
-    notes.push("an agent at work");
-  }
   return `#${task.number}  ${task.state}  ${task.priority}  ${task.title}  (${notes.join("; ")})`;
 }
 
@@ -128,6 +127,9 @@ export function formatRunLine(run: RestRun): string {
   if (run.waitingFor !== null) {
     notes.push(`waiting for decision ${run.waitingFor}`);
   }
+  if (run.endedAt === null) {
+    notes.push(`last heard ${run.lastHeardAt}`);
+  }
   return `${run.id}  ${run.status}  ${run.agent} for ${run.person.login}  task #${run.taskNumber}  (${notes.join(", ")})`;
 }
 

package/src/cli/help.ts

@@ -1,4 +1,5 @@
 import {
+  DEFAULT_PAGE_LIMIT,
   MAX_AGENT_LENGTH,
   MAX_ARTIFACTS_PER_RUN,
   MAX_BODY_LENGTH,
@@ -105,9 +106,8 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   },
   tasks: {
     usage:
-      "tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day|today|week|overdue>]",
-    about:
-      "The tasks on the board, newest first: number, state, priority, title, who owns and works on each, its category and its due day, and what waits on it. --open keeps the ones not done or dropped, --mine those assigned to you, --category and --goal those sorted into one, --due those due by a day: today, within the week, or overdue (the open ones past their day). States: idea, ready, in_progress, in_review, done, dropped.",
+      "tasks [--state <state>] [--open] [--mine] [--category <key>] [--goal <id>] [--due <day|today|week|overdue>] [--limit <n>] [--offset <n>]",
+    about: `The tasks on the board, newest first: number, state, priority, title, who owns and works on each, its category and its due day, and what waits on it. --open keeps the ones not done or dropped, --mine those assigned to you, --category and --goal those sorted into one, --due those due by a day: today, within the week, or overdue (the open ones past their day). A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on; a last line says when there is more. States: idea, ready, in_progress, in_review, done, dropped.`,
   },
   task: {
     usage: `task <number|id>  |  task new <title> [--body <markdown>|--file <path>] ${TASK_FIELD_FLAGS}  |  task edit <number|id> [--title <title>] [--body <markdown>|--file <path>] ${TASK_FIELD_FLAGS}`,
@@ -153,11 +153,10 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
   take: {
     usage: "take <number|id> [--agent <name>]",
     about:
-      "Takes a task: a run begins, and the task is in progress and the person's. One agent at a time per task. --agent is what people see at work; left out, it is what the person called the token.",
+      "Takes a task: a run begins, and the task is in progress and the person's. A run still open on the task is taken over, since the board cannot know whether its agent still runs: it ends as abandoned, the feed says who took over, and that agent is refused on its next command. Look before taking (console task <number> lists the runs, with when each was last heard from), and take a task another agent was heard from on lately only when told to. --agent is what people see at work; left out, it is what the person called the token.",
     limits: [`agent: one line, up to ${MAX_AGENT_LENGTH} characters`],
     refusals: [
       "task.not_found: no task has that number or id",
-      "run.task_taken: a run is open on the task already; console runs --open --mine shows whether it is yours",
       "run.task_closed: the task is done or dropped",
     ],
   },
@@ -207,8 +206,8 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     refusals: ["decision.not_found: no decision has that id"],
   },
   decisions: {
-    usage: "decisions [--open]",
-    about: "The decisions on the board, the waiting first; --open keeps only those.",
+    usage: "decisions [--open] [--limit <n>] [--offset <n>]",
+    about: `The decisions on the board, the waiting first; --open keeps only those. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on.`,
   },
   finish: {
     usage: 'finish [--summary "<markdown>"|--file <path>]',
@@ -231,9 +230,8 @@ export const COMMAND_HELP: Readonly<Record<string, CommandHelp>> = {
     refusals: RUN_REFUSALS,
   },
   runs: {
-    usage: "runs [--task <number|id>] [--open] [--mine]",
-    about:
-      "The runs, newest first: agents at work and what they did. --mine keeps those begun with this token.",
+    usage: "runs [--task <number|id>] [--open] [--mine] [--limit <n>] [--offset <n>]",
+    about: `The runs, newest first, each with when its agent was last heard from: --open keeps the ones not over, --mine those begun with this token. A page at a time: ${DEFAULT_PAGE_LIMIT} unless --limit says otherwise, from --offset on.`,
   },
   run: {
     usage: "run <id>",
@@ -312,6 +310,8 @@ Usage: console <command> [arguments] [--json] [--url <origin>] [--project <key>]
 
 const CLOSING = `Options everywhere: --json answers with the console's own JSON; --url names another console;
 --project names the project to work in, over CONSOLE_PROJECT and over what console use kept here.
+A listing (tasks, decisions, runs) is a page at a time: --limit <n> and --offset <n>, and a last line
+says when there is more, so that nothing is read that is not needed.
 Commands on a run (report, hand-in, ask, finish, fail) act on your one open run in the project;
 with several open, say which with --run <id>. A Markdown body given as - is read from standard input.
 console help <command> says what each command takes, the limits the console holds it to, and

package/src/client.ts

@@ -150,8 +150,14 @@ export interface EventFilter {
   readonly document?: string | undefined;
 }
 
+/** One page of a listing: how many items, from which one on; the server's bounds apply. */
+export interface Page {
+  readonly limit?: number | undefined;
+  readonly offset?: number | undefined;
+}
+
 /** What the board is narrowed to: one state, the open ones, a category, a goal, an assignee, or what is due by a day. */
-export interface TaskFilter {
+export interface TaskFilter extends Page {
   readonly state?: TaskState | undefined;
   /** True for the tasks not done or dropped; false for the rest. */
   readonly open?: boolean | undefined;
@@ -183,6 +189,10 @@ export interface ProjectClient {
   get(signal?: AbortSignal): Promise<RestProject>;
   /** Changes the project's settings; for an owner. */
   update(patch: RestProjectPatch): Promise<RestProject>;
+  /** Sets the project's own image for its mark, sent as a form; for an owner on the console's own pages. */
+  setIcon(input: FileUpload): Promise<RestProject>;
+  /** Takes the image away: the mark is the symbol on the colour again. */
+  removeIcon(): Promise<RestProject>;
   /** Those listed in the project, by login. */
   members(signal?: AbortSignal): Promise<RestMembers>;
   /** Lists a person of the workspace in the project; for an owner. */
@@ -194,9 +204,9 @@ export interface ProjectClient {
   task(ref: string, signal?: AbortSignal): Promise<RestTask>;
   createTask(input: RestTaskInput): Promise<RestTask>;
   updateTask(id: string, patch: RestTaskPatch): Promise<RestTask>;
-  /** The decisions, or only those that wait, or only those about one task. */
+  /** The decisions, or only those that wait, or only those about one task; a page of them. */
   decisions(
-    filter?: { readonly open?: boolean; readonly task?: string },
+    filter?: { readonly open?: boolean; readonly task?: string } & Page,
     signal?: AbortSignal,
   ): Promise<RestDecisions>;
   decision(id: string, signal?: AbortSignal): Promise<RestDecision>;
@@ -209,9 +219,9 @@ export interface ProjectClient {
   answerDecision(id: string, input: RestAnswerInput): Promise<RestDecision>;
   /** Grows a decision's record: its context, or what followed. */
   updateDecision(id: string, patch: RestDecisionPatch): Promise<RestDecision>;
-  /** The runs, newest first; or only those on one task, only the open ones, only the asker's own. */
+  /** The runs, newest first; or only those on one task, only the open ones, only the asker's own; a page of them. */
   runs(
-    filter?: { readonly task?: string; readonly open?: boolean; readonly mine?: boolean },
+    filter?: { readonly task?: string; readonly open?: boolean; readonly mine?: boolean } & Page,
     signal?: AbortSignal,
   ): Promise<RestRuns>;
   run(id: string, signal?: AbortSignal): Promise<RestRun>;
@@ -381,6 +391,8 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
 
   const flag = (value: boolean | undefined): string | undefined =>
     value === undefined ? undefined : String(value);
+  const number = (value: number | undefined): string | undefined =>
+    value === undefined ? undefined : String(value);
 
   /** A file as the parts of a form: the bytes with their name and type, and the label. */
   const formOf = (input: FileUpload): FormData => {
@@ -405,6 +417,8 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
       key,
       get: (signal) => request("GET", `${base}${at()}`, undefined, restProjectSchema, signal),
       update: (patch) => request("PATCH", `${base}${at()}`, patch, restProjectSchema),
+      setIcon: (input) => request("POST", `${base}${at()}/icon`, formOf(input), restProjectSchema),
+      removeIcon: () => request("DELETE", `${base}${at()}/icon`, undefined, restProjectSchema),
       members: (signal) =>
         request("GET", `${base}${at("members")}`, undefined, restMembersSchema, signal),
       addMember: (input) => request("POST", `${base}${at("members")}`, input, restMemberSchema),
@@ -422,6 +436,8 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
             goal: filter.goal,
             assignee: filter.assignee,
             dueBy: filter.dueBy,
+            limit: number(filter.limit),
+            offset: number(filter.offset),
           }),
           undefined,
           restTasksSchema,
@@ -435,7 +451,12 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
       decisions: (filter = {}, signal) =>
         request(
           "GET",
-          withQuery(at("decisions"), { open: flag(filter.open), task: filter.task }),
+          withQuery(at("decisions"), {
+            open: flag(filter.open),
+            task: filter.task,
+            limit: number(filter.limit),
+            offset: number(filter.offset),
+          }),
           undefined,
           restDecisionsSchema,
           signal,
@@ -463,6 +484,8 @@ export function createClient(options: ClientOptions = {}): ConsoleClient {
             task: filter.task,
             open: flag(filter.open),
             mine: flag(filter.mine),
+            limit: number(filter.limit),
+            offset: number(filter.offset),
           }),
           undefined,
           restRunsSchema,