@skillcdn/console 0.1.0 → 0.1.2

package/README.md

@@ -30,25 +30,27 @@ const { items } = await client.tasks({ state: "ready" });
 
 - **The vocabulary:** `TASK_STATES`, `TASK_PRIORITIES`, `RUN_STATUSES`, `EVENT_KINDS`, with their types. One source for the database's constraints, the schemas and the board.
 - **The bounds** every input is held to (`MAX_TITLE_LENGTH`, `MAX_BODY_LENGTH`, `MAX_OPTIONS`, ...), so that a page can say so before a request is made.
-- **The routes:** `REST_ROUTES`, `AUTH_ROUTES`, and the helpers that build a path (`restPath`, `loginPath`, `signInPath`). The API itself is described in [docs/specs/rest.md](https://github.com/skillcdn/console/blob/main/docs/specs/rest.md).
-- **The schemas,** in the mini build of zod, which runs in a browser: what the server answers (`restTaskSchema`, `restDecisionSchema`, `restEventSchema`, `restMeSchema`, ...) and what it is sent (`restTaskInputSchema`, `restTaskPatchSchema`, `restDecisionInputSchema`, `restAnswerInputSchema`). Absent values are `null` on the wire, never missing keys. The server validates with the input schemas and is tested against the others.
-- **The client:** `createClient({ baseUrl, fetch })` answers typed values parsed with those schemas, and throws an `ApiError` with the server's stable `code` (or `network`, `invalid_response`) for anything else. It takes a `fetch` and reads nothing else. With `token`, a token a person made on their Tokens page, every request carries `Authorization: Bearer` and no cookie: how a script or a console of a person's own acts as that person. An `EventSource` cannot carry a header, so a stream read with a token is a `fetch` of `eventStreamUrl(after)`. `handInFile` sends a file as a form, and `fileUrl` says where its bytes are read back. `skills()` reads the organization's skills as the console serves them by address.
+- **The routes:** `REST_ROUTES` (the workspace's resources), `AUTH_ROUTES`, and the helpers that build a path (`projectPath(key, collection, id)` for everything under a project, `restPath`, `loginPath`, `signInPath`). The API itself is described in [docs/specs/rest.md](https://github.com/skillcdn/console/blob/main/docs/specs/rest.md).
+- **The schemas,** in the mini build of zod, which runs in a browser: what the server answers (`restProjectSchema`, `restMemberSchema`, `restTaskSchema`, `restDecisionSchema`, `restEventSchema`, `restMeSchema`, ...) and what it is sent (`restProjectInputSchema`, `restTaskInputSchema`, `restTaskPatchSchema`, `restDecisionInputSchema`, `restAnswerInputSchema`, ...). Absent values are `null` on the wire, never missing keys. The server validates with the input schemas and is tested against the others.
+- **The client:** `createClient({ baseUrl, fetch })` answers typed values parsed with those schemas, and throws an `ApiError` with the server's stable `code` (or `network`, `invalid_response`) for anything else. It takes a `fetch` and reads nothing else. With `token`, a token a person made on their Tokens page, every request carries `Authorization: Bearer` and no cookie: how a script or a console of a person's own acts as that person. The board is a project's: `client.projects()` lists those the person may see, and `client.project(key)` is the client of one, with its tasks, decisions, runs, files, events, skills, settings and members. An `EventSource` cannot carry a header, so a stream read with a token is a `fetch` of `eventStreamUrl(after)`. `handInFile` sends a file as a form, and `fileUrl` says where its bytes are read back. `events(after, { task })` is everything that happened to one task.
 
 ### The command line
 
 ```sh
-npm install -g @skillcdn/console                 # where the agent runs, once the package is published
+npm install -g @skillcdn/console                 # where the agent runs
 console login --url https://console.example      # asks for a token made on the Tokens page, and keeps it
-console take 7                                   # a run begins on task #7, for the person the token is
+console use web                                  # the project this directory works in; .skillcdn-console.json, committed
+console take 7                                   # a run begins on task #7 of the project, for the person the token is
 console report "Found the cause: the parser trusts its input."
 console hand-in ./report.md --label "the report"  # a file the console keeps, or an https link
-console skills                                   # the organization's skills, with the URI to load each by
+console skills                                   # the project's skills, with the URI to load each by
 console ask "Keep the old behaviour?" --option "Keep it" --option "Change it"
 console finish --summary "Done: the parser refuses empty input."
 ```
 
-- **`console`** is the agent's side of the console ([docs/specs/cli.md](https://github.com/skillcdn/console/blob/main/docs/specs/cli.md)): a thin client of the REST API with no logic of its own, no dependencies beyond the package's, and no cost to an agent until it is used. `console help` says everything an agent needs; `--json` answers with the console's own JSON; the exit code says whether the console did it (`0`), refused or could not be reached (`1`), did not understand (`2`), or a decision still waits (`3`).
+- **`console`** is the agent's side of the console ([docs/specs/cli.md](https://github.com/skillcdn/console/blob/main/docs/specs/cli.md)): a thin client of the REST API with no logic of its own, no dependencies beyond the package's, and no cost to an agent until it is used. `console help` says everything an agent needs and `console --version` which version this is; `--json` answers with the console's own JSON; the exit code says whether the console did it (`0`), refused or could not be reached (`1`), did not understand (`2`), or a decision still waits (`3`).
 - **A person signs it in once:** `login` checks the token against the console and keeps it, with the console's address, in `$XDG_CONFIG_HOME/skillcdn-console/credentials.json` (`~/.config` when unset). `CONSOLE_URL` and `CONSOLE_TOKEN` in the environment win over the file, for a hook or a job. A token is never taken on the command line.
+- **Every command on the board works in one project:** `--project <key>`, else `CONSOLE_PROJECT`, else what `console use <key>` wrote to `.skillcdn-console.json` in the working directory or one above it, a file meant to be committed. `console projects` lists the projects the person may work in.
 - **`@skillcdn/console/cli`** exports `runCli(argv, io)`, the command as a function that takes its environment, its streams, its `fetch` and its credential store: what the integration tests run against the app with no socket, and what a console of a person's own could embed.
 
 ### The components and the composition
@@ -59,12 +61,12 @@ import "@skillcdn/console/console.css";
 
 createConsole({
   title: "Acme", // until the server says what the board is called
-  components: { SignIn: MySignIn }, // any of Shell, Board, TaskView, DecisionList, EventFeed, SignIn, TokenList, PeopleList, SkillList
+  components: { SignIn: MySignIn }, // any of Shell, Board, TaskView, DecisionList, EventFeed, SignIn, TokenList, PeopleList, SkillList, ProjectList, MemberList
 }).mount(document.getElementById("root"));
 ```
 
-- **The components** take their data as props and nothing from the network: `Board` (one column per state), `TaskCard`, `TaskView` (one task with its decisions and its parts), `TaskForm`, `DecisionList` and `DecisionCard` (the waiting first, each with the way to answer), `DecisionForm`, `EventFeed` (a sentence per event, newest first; `describeEvent` makes the sentence), `Shell` (the header with the pages and the person), `SignIn` (one button per provider the deployment offers), `TokenList`, `TokenForm` and `NewToken` (the tokens a person holds, the way to make one, and the one just made with its secret shown once), `PeopleList` (everyone, with what each is, and the way for an administrator to change it), `SkillList` (the organization's skills as SkillCDN serves them at the console's address, each with where a person reads it and what an agent loads it by), `RunList` and `RunCard` (an agent at work on a task: what it reported, what it handed in, links and files alike, what it waits for; `RunStatusBadge` and `RUN_STATUS_LABELS` with them, and `fileHref` for a console served from another origin than its API), and `Markdown`, which renders what people and agents wrote as elements, never as HTML, with links to the web only and pictures over https only. The small blocks (`Button`, `Badge`, `Avatar`, `PersonChip`, `Callout`, `EmptyState`, `Spinner`, `Time`) and the words of the vocabulary (`STATE_LABELS`, `PRIORITY_LABELS`, `ROLE_LABELS`, with `RoleBadge`) are exported too.
-- **The composition:** `createConsole(config)` returns `{ App, mount }`. `App` is the whole console as one component; `mount(container)` renders it and returns the way to take it down. `config.baseUrl` is the origin of the API (the page's own when left out), `config.components` the pieces to replace (`ConsoleComponents` names them with the props each takes), `config.client` a client of your own, for tests. The pages route in the browser (`matchRoute`, `PATHS`, `taskHref`); the data is loaded whole and kept current by the server's stream (`useConsoleData`, for a composition of your own).
+- **The components** take their data as props and nothing from the network: `Board` (one column per state), `TaskCard`, `TaskView` (one task with its decisions and its parts), `TaskForm`, `DecisionList` and `DecisionCard` (the waiting first, each with the way to answer), `DecisionForm`, `EventFeed` (a sentence per event, newest first; `describeEvent` makes the sentence), `Shell` (the header with the pages and the person), `SignIn` (one button per provider the deployment offers), `TokenList`, `TokenForm` and `NewToken` (the tokens a person holds, the way to make one, and the one just made with its secret shown once), `PeopleList` (everyone, with what each is, and the way for an administrator to change it), `ProjectList`, `ProjectForm` and `MemberList` (the projects a person may see with what they are in each, the way to make or change one, and those listed in a project with the way for an owner to add, change and remove them; `ProjectRoleBadge`, `PROJECT_ROLE_LABELS`, `VISIBILITY_LABELS` and `keyOf` with them), `SkillList` (a project's skills as SkillCDN serves them at its address, each with where a person reads it and what an agent loads it by), `RunList` and `RunCard` (an agent at work on a task: what it reported, what it handed in, links and files alike, what it waits for; `RunStatusBadge` and `RUN_STATUS_LABELS` with them, and `fileHref` for where a file is read), and `Markdown`, which renders what people and agents wrote as elements, never as HTML, with links to the web only and pictures over https only. The small blocks (`Button`, `Badge`, `Avatar`, `PersonChip`, `Callout`, `EmptyState`, `Spinner`, `Time`) and the words of the vocabulary (`STATE_LABELS`, `PRIORITY_LABELS`, `ROLE_LABELS`, with `RoleBadge`) are exported too.
+- **The composition:** `createConsole(config)` returns `{ App, mount }`. `App` is the whole console as one component; `mount(container)` renders it and returns the way to take it down. `config.baseUrl` is the origin of the API (the page's own when left out), `config.components` the pieces to replace (`ConsoleComponents` names them with the props each takes), `config.client` a client of your own, for tests. The pages route in the browser: the projects at `/`, a project's pages under `/p/<key>` (`matchRoute`, `PATHS`, `projectHref`, `taskHref`); the workspace is loaded once and the project the page is on whole, kept current by the project's stream (`useConsoleData(client, projectKey)`, for a composition of your own).
 - **The styles** are one file, `@skillcdn/console/console.css`: the tokens (`--sc-*`), a small reset, and one class per block, all prefixed `sc-`. Re-skinning starts and mostly ends with the tokens.
 - React 19 is a peer dependency; `react-markdown` and `remark-gfm` are the package's own.
 

package/dist/api.d.ts

@@ -1,7 +1,7 @@
-export { ApiError, type ClientOptions, type ConsoleClient, createClient, type FetchLike, type FileUpload, } from "./client.js";
-export { DEFAULT_TOKEN_DAYS, EVENTS_PAGE_LIMIT, LIST_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_FILE_NAME_LENGTH, MAX_LINK_LABEL_LENGTH, MAX_LINKS, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MAX_TOKEN_DAYS, MAX_TOKEN_NAME_LENGTH, MAX_TOKENS_PER_PERSON, MAX_URL_LENGTH, MIN_OPTIONS, } from "./limits.js";
-export { AUTH_ROUTES, isSignInFailure, loginPath, REST_ROUTES, RETURN_TO_PARAM, restPath, SIGN_IN_FAILURES, SIGN_IN_PARAM, type SignInFailure, signInPath, } from "./routes.js";
-export { type RestAnswerInput, type RestArtifact, type RestArtifactInput, type RestDecision, type RestDecisionInput, type RestDecisionOption, type RestDecisions, type RestError, type RestEvent, type RestEventData, type RestEvents, type RestFile, type RestFileInput, type RestMe, type RestPeople, type RestPerson, type RestPersonPatch, type RestProvider, type RestReport, type RestReportInput, type RestRun, type RestRunEndInput, type RestRunInput, type RestRuns, type RestSkill, type RestSkills, type RestTask, type RestTaskInput, type RestTaskLink, type RestTaskPatch, type RestTasks, type RestToken, type RestTokenCreated, type RestTokenInput, type RestTokens, restAnswerInputSchema, restArtifactInputSchema, restArtifactSchema, restDecisionInputSchema, restDecisionOptionSchema, restDecisionSchema, restDecisionsSchema, restErrorSchema, restEventDataSchema, restEventSchema, restEventsSchema, restFileInputSchema, restFileSchema, restMeSchema, restPeopleSchema, restPersonPatchSchema, restPersonSchema, restProviderSchema, restReportInputSchema, restReportSchema, restRunEndInputSchema, restRunInputSchema, restRunSchema, restRunsSchema, restSkillSchema, restSkillsSchema, restTaskInputSchema, restTaskLinkSchema, restTaskPatchSchema, restTaskSchema, restTasksSchema, restTokenCreatedSchema, restTokenInputSchema, restTokenSchema, restTokensSchema, } from "./schemas.js";
+export { ApiError, type ClientOptions, type ConsoleClient, createClient, type EventFilter, type FetchLike, type FileUpload, type ProjectClient, } from "./client.js";
+export { DEFAULT_TOKEN_DAYS, EVENTS_PAGE_LIMIT, LIST_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_FILE_NAME_LENGTH, MAX_LINK_LABEL_LENGTH, MAX_LINKS, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_PROJECT_DESCRIPTION_LENGTH, MAX_PROJECT_KEY_LENGTH, MAX_PROJECT_NAME_LENGTH, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SKILLS_ADDRESS_LENGTH, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MAX_TOKEN_DAYS, MAX_TOKEN_NAME_LENGTH, MAX_TOKENS_PER_PERSON, MAX_URL_LENGTH, MIN_OPTIONS, } from "./limits.js";
+export { AUTH_ROUTES, isSignInFailure, loginPath, PROJECT_COLLECTIONS, type ProjectCollection, projectPath, REST_ROUTES, RETURN_TO_PARAM, restPath, SIGN_IN_FAILURES, SIGN_IN_PARAM, type SignInFailure, signInPath, } from "./routes.js";
+export { type RestAnswerInput, type RestArtifact, type RestArtifactInput, type RestDecision, type RestDecisionInput, type RestDecisionOption, type RestDecisions, type RestError, type RestEvent, type RestEventData, type RestEvents, type RestFile, type RestFileInput, type RestMe, type RestMember, type RestMemberInput, type RestMemberPatch, type RestMembers, type RestPeople, type RestPerson, type RestPersonPatch, type RestProject, type RestProjectInput, type RestProjectPatch, type RestProjects, type RestProvider, type RestReport, type RestReportInput, type RestRun, type RestRunEndInput, type RestRunInput, type RestRuns, type RestSkill, type RestSkills, type RestTask, type RestTaskInput, type RestTaskLink, type RestTaskPatch, type RestTasks, type RestToken, type RestTokenCreated, type RestTokenInput, type RestTokens, restAnswerInputSchema, restArtifactInputSchema, restArtifactSchema, restDecisionInputSchema, restDecisionOptionSchema, restDecisionSchema, restDecisionsSchema, restErrorSchema, restEventDataSchema, restEventSchema, restEventsSchema, restFileInputSchema, restFileSchema, restMemberInputSchema, restMemberPatchSchema, restMemberSchema, restMembersSchema, restMeSchema, restPeopleSchema, restPersonPatchSchema, restPersonSchema, restProjectInputSchema, restProjectPatchSchema, restProjectSchema, restProjectsSchema, restProviderSchema, restReportInputSchema, restReportSchema, restRunEndInputSchema, restRunInputSchema, restRunSchema, restRunsSchema, restSkillSchema, restSkillsSchema, restTaskInputSchema, restTaskLinkSchema, restTaskPatchSchema, restTaskSchema, restTasksSchema, restTokenCreatedSchema, restTokenInputSchema, restTokenSchema, restTokensSchema, } from "./schemas.js";
 export { hasForbiddenCodePoint } from "./text.js";
-export { ARTIFACT_KINDS, type ArtifactKind, EVENT_KINDS, type EventKind, isProviderKey, PERSON_ROLES, type PersonRole, PROVIDER_KEYS, type ProviderKey, RUN_ENDINGS, RUN_STATUSES, type RunEnding, type RunStatus, SKILLS_STATUSES, type SkillsStatus, TASK_PRIORITIES, TASK_STATES, type TaskPriority, type TaskState, } from "./vocabulary.js";
+export { ARTIFACT_KINDS, type ArtifactKind, EVENT_KINDS, type EventKind, isProviderKey, PERSON_ROLES, type PersonRole, PROJECT_ROLES, PROJECT_VISIBILITIES, PROVIDER_KEYS, type ProjectRole, type ProjectVisibility, type ProviderKey, RUN_ENDINGS, RUN_STATUSES, type RunEnding, type RunStatus, SKILLS_STATUSES, type SkillsStatus, TASK_PRIORITIES, TASK_STATES, type TaskPriority, type TaskState, } from "./vocabulary.js";
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,WAAW,EACX,KAAK,SAAS,EACd,aAAa,EACb,YAAY,EACZ,KAAK,UAAU,EACf,aAAa,EACb,KAAK,WAAW,EAChB,WAAW,EACX,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,eAAe,EACf,KAAK,YAAY,EACjB,eAAe,EACf,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -3,9 +3,9 @@
 // custom UI talks to any console with types, and so that the contract has one source. No React
 // here: the server and the command line import this entry point, and nothing of the pages.
 export { ApiError, createClient, } from "./client.js";
-export { DEFAULT_TOKEN_DAYS, EVENTS_PAGE_LIMIT, LIST_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_FILE_NAME_LENGTH, MAX_LINK_LABEL_LENGTH, MAX_LINKS, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MAX_TOKEN_DAYS, MAX_TOKEN_NAME_LENGTH, MAX_TOKENS_PER_PERSON, MAX_URL_LENGTH, MIN_OPTIONS, } from "./limits.js";
-export { AUTH_ROUTES, isSignInFailure, loginPath, REST_ROUTES, RETURN_TO_PARAM, restPath, SIGN_IN_FAILURES, SIGN_IN_PARAM, signInPath, } from "./routes.js";
-export { restAnswerInputSchema, restArtifactInputSchema, restArtifactSchema, restDecisionInputSchema, restDecisionOptionSchema, restDecisionSchema, restDecisionsSchema, restErrorSchema, restEventDataSchema, restEventSchema, restEventsSchema, restFileInputSchema, restFileSchema, restMeSchema, restPeopleSchema, restPersonPatchSchema, restPersonSchema, restProviderSchema, restReportInputSchema, restReportSchema, restRunEndInputSchema, restRunInputSchema, restRunSchema, restRunsSchema, restSkillSchema, restSkillsSchema, restTaskInputSchema, restTaskLinkSchema, restTaskPatchSchema, restTaskSchema, restTasksSchema, restTokenCreatedSchema, restTokenInputSchema, restTokenSchema, restTokensSchema, } from "./schemas.js";
+export { DEFAULT_TOKEN_DAYS, EVENTS_PAGE_LIMIT, LIST_LIMIT, MAX_AGENT_LENGTH, MAX_ARTIFACTS_PER_RUN, MAX_BODY_LENGTH, MAX_FILE_BYTES, MAX_FILE_NAME_LENGTH, MAX_LINK_LABEL_LENGTH, MAX_LINKS, MAX_NOTE_LENGTH, MAX_OPTION_LABEL_LENGTH, MAX_OPTIONS, MAX_PROJECT_DESCRIPTION_LENGTH, MAX_PROJECT_KEY_LENGTH, MAX_PROJECT_NAME_LENGTH, MAX_QUESTION_LENGTH, MAX_REPORTS_PER_RUN, MAX_SKILLS_ADDRESS_LENGTH, MAX_SUMMARY_LENGTH, MAX_TITLE_LENGTH, MAX_TOKEN_DAYS, MAX_TOKEN_NAME_LENGTH, MAX_TOKENS_PER_PERSON, MAX_URL_LENGTH, MIN_OPTIONS, } from "./limits.js";
+export { AUTH_ROUTES, isSignInFailure, loginPath, PROJECT_COLLECTIONS, projectPath, REST_ROUTES, RETURN_TO_PARAM, restPath, SIGN_IN_FAILURES, SIGN_IN_PARAM, signInPath, } from "./routes.js";
+export { restAnswerInputSchema, restArtifactInputSchema, restArtifactSchema, restDecisionInputSchema, restDecisionOptionSchema, restDecisionSchema, restDecisionsSchema, restErrorSchema, restEventDataSchema, restEventSchema, restEventsSchema, restFileInputSchema, restFileSchema, restMemberInputSchema, restMemberPatchSchema, restMemberSchema, restMembersSchema, restMeSchema, restPeopleSchema, restPersonPatchSchema, restPersonSchema, restProjectInputSchema, restProjectPatchSchema, restProjectSchema, restProjectsSchema, restProviderSchema, restReportInputSchema, restReportSchema, restRunEndInputSchema, restRunInputSchema, restRunSchema, restRunsSchema, restSkillSchema, restSkillsSchema, restTaskInputSchema, restTaskLinkSchema, restTaskPatchSchema, restTaskSchema, restTasksSchema, restTokenCreatedSchema, restTokenInputSchema, restTokenSchema, restTokensSchema, } from "./schemas.js";
 export { hasForbiddenCodePoint } from "./text.js";
-export { ARTIFACT_KINDS, EVENT_KINDS, isProviderKey, PERSON_ROLES, PROVIDER_KEYS, RUN_ENDINGS, RUN_STATUSES, SKILLS_STATUSES, TASK_PRIORITIES, TASK_STATES, } from "./vocabulary.js";
+export { ARTIFACT_KINDS, EVENT_KINDS, isProviderKey, PERSON_ROLES, PROJECT_ROLES, PROJECT_VISIBILITIES, PROVIDER_KEYS, RUN_ENDINGS, RUN_STATUSES, SKILLS_STATUSES, TASK_PRIORITIES, TASK_STATES, } from "./vocabulary.js";
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,8FAA8F;AAC9F,+FAA+F;AAC/F,2FAA2F;AAE3F,OAAO,EACL,QAAQ,EAGR,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAEb,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAoCL,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,cAAc,EAEd,WAAW,EAEX,aAAa,EACb,YAAY,EAEZ,aAAa,EAEb,WAAW,EACX,YAAY,EAGZ,eAAe,EAEf,eAAe,EACf,WAAW,GAGZ,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,8FAA8F;AAC9F,+FAA+F;AAC/F,2FAA2F;AAE3F,OAAO,EACL,QAAQ,EAGR,YAAY,GAKb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,8BAA8B,EAC9B,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,eAAe,EACf,SAAS,EACT,mBAAmB,EAEnB,WAAW,EACX,WAAW,EACX,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAEb,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EA4CL,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EACL,cAAc,EAEd,WAAW,EAEX,aAAa,EACb,YAAY,EAEZ,aAAa,EACb,oBAAoB,EACpB,aAAa,EAIb,WAAW,EACX,YAAY,EAGZ,eAAe,EAEf,eAAe,EACf,WAAW,GAGZ,MAAM,iBAAiB,CAAC"}

package/dist/cli/cli.d.ts

@@ -1,5 +1,6 @@
 import { type FetchLike } from "../client.js";
 import type { CredentialStore } from "./credentials.js";
+import type { DirectoryStore } from "./directory.js";
 /** The exit codes of the command, for whoever runs it: a shell, a hook, an agent. */
 export declare const EXIT: {
     readonly ok: 0;
@@ -24,8 +25,12 @@ export interface CliIo {
     /** A file handed in, as bytes. */
     readonly readBytes: (path: string) => Promise<Uint8Array>;
     readonly store: CredentialStore;
+    /** What the working directory says of the project, and the way to write it. */
+    readonly directory: DirectoryStore;
     readonly sleep: (ms: number) => Promise<void>;
     readonly now: () => number;
+    /** The version of the package the command runs from, when the entry point knows it. */
+    readonly version?: string | undefined;
 }
 /** Runs the command and answers with its exit code. What it prints goes through `io`. */
 export declare function runCli(argv: readonly string[], io: CliIo): Promise<number>;

package/dist/cli/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAmBxD,qFAAqF;AACrF,eAAO,MAAM,IAAI;aACf,EAAE,EAAE,CAAC;IACL,6EAA6E;aAC7E,MAAM,EAAE,CAAC;IACT,sCAAsC;aACtC,KAAK,EAAE,CAAC;IACR,6CAA6C;aAC7C,OAAO,EAAE,CAAC;CACF,CAAC;AAWX,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;CAC5B;AA4nBD,yFAAyF;AACzF,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,SAAS,EAEf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBrD,qFAAqF;AACrF,eAAO,MAAM,IAAI;aACf,EAAE,EAAE,CAAC;IACL,6EAA6E;aAC7E,MAAM,EAAE,CAAC;IACT,sCAAsC;aACtC,KAAK,EAAE,CAAC;IACR,6CAA6C;aAC7C,OAAO,EAAE,CAAC;CACF,CAAC;AAWX,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAqsBD,yFAAyF;AACzF,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BhF"}

package/dist/cli/cli.js

@@ -1,14 +1,15 @@
 import { basename, extname } from "node:path";
 import { parseArgs } from "node:util";
-import { ApiError, createClient } from "../client.js";
+import { ApiError, createClient, } from "../client.js";
 import { MAX_OPTIONS, MIN_OPTIONS } from "../limits.js";
 import { TASK_PRIORITIES, TASK_STATES } from "../vocabulary.js";
-import { formatAnswer, formatDecision, formatDecisionLine, formatOptions, formatRun, formatRunLine, formatSkills, formatTask, formatTaskLine, } from "./format.js";
+import { formatAnswer, formatDecision, formatDecisionLine, formatOptions, formatProjectLine, formatRun, formatRunLine, formatSkills, formatTask, formatTaskLine, } from "./format.js";
 import { COMMAND_HELP, helpFor, usage } from "./help.js";
 // The `console` command (docs/specs/cli.md): the agent's side of the console. A thin client of
 // the REST API with no logic of its own: every command is one or two requests and the words to
 // say what came back. It takes what it needs from `CliIo`, so that tests run it whole, against
-// the app and no socket, with a store and readers of their own.
+// the app and no socket, with a store and readers of their own. The board is a project's: every
+// command on it works in the project the flag, the environment or the working directory names.
 /** The exit codes of the command, for whoever runs it: a shell, a hook, an agent. */
 export const EXIT = {
     ok: 0,
@@ -38,7 +39,11 @@ class CliExit extends Error {
 }
 const failed = (message) => new CliExit(EXIT.failed, message);
 const misuse = (message) => new CliExit(EXIT.usage, message);
-const GLOBAL_OPTIONS = { json: { type: "boolean" }, url: { type: "string" } };
+const GLOBAL_OPTIONS = {
+    json: { type: "boolean" },
+    url: { type: "string" },
+    project: { type: "string" },
+};
 function parse(args, options, allowPositionals = true) {
     try {
         return parseArgs({
@@ -64,6 +69,7 @@ const texts = (values, name) => {
     }
     return typeof value === "string" ? [value] : [];
 };
+const NO_PROJECT = "Say which project: --project <key>, CONSOLE_PROJECT in the environment, or console use <key> once in this directory. console projects lists the projects you may work in.";
 /** The console and the token to talk to it with: the flags, the environment, then what login kept. */
 async function open(io, values) {
     const stored = await io.store.load();
@@ -72,29 +78,39 @@ async function open(io, values) {
     if (url === undefined || token === undefined) {
         throw failed("Not signed in. A person signs the command in: console login --url <the console's origin>");
     }
+    const client = createClient({ baseUrl: url, token, fetch: io.fetch });
+    const projectKey = async () => text(values, "project") ?? io.env.CONSOLE_PROJECT ?? (await io.directory.load())?.project;
     return {
-        client: createClient({ baseUrl: url, token, fetch: io.fetch }),
+        client,
         url,
         json: on(values, "json"),
+        projectKey,
+        async project() {
+            const key = await projectKey();
+            if (key === undefined) {
+                throw failed(NO_PROJECT);
+            }
+            return client.project(key);
+        },
     };
 }
 /** Prints what came back: the console's JSON on `--json`, the words otherwise. */
 function answer(io, session, value, words) {
     io.stdout(session.json ? `${JSON.stringify(value, null, 2)}\n` : `${words()}\n`);
 }
-/** The run a command on a run means: the one named, else the one open run of this token. */
-async function currentRun(session, values) {
+/** The run a command on a run means: the one named, else the one open run of this token in the project. */
+async function currentRun(project, values) {
     const given = text(values, "run");
     if (given !== undefined) {
         return given;
     }
-    const { items } = await session.client.runs({ open: true, mine: true });
+    const { items } = await project.runs({ open: true, mine: true });
     const [only] = items;
     if (only !== undefined && items.length === 1) {
         return only.id;
     }
     if (items.length === 0) {
-        throw failed("No run of yours is open. Take a task first: console take <number>");
+        throw failed("No run of yours is open in this project. Take a task first: console take <number>");
     }
     throw failed(`Several runs of yours are open; say which with --run <id>:\n${items.map((run) => `  ${formatRunLine(run)}`).join("\n")}`);
 }
@@ -159,7 +175,7 @@ function theOne(positionals, ask) {
  * The decision once answered, or as it stands when the wait is over. Each request asks the
  * console to hold it for a while, so the answer arrives as soon as a person gives it.
  */
-async function waitForAnswer(io, client, decision, seconds) {
+async function waitForAnswer(io, project, decision, seconds) {
     const deadline = io.now() + seconds * 1000;
     let current = decision;
     for (;;) {
@@ -167,7 +183,7 @@ async function waitForAnswer(io, client, decision, seconds) {
         if (current.answer !== null || left <= 0) {
             return current;
         }
-        current = await client.awaitDecision(current.id, Math.max(1, Math.min(Math.ceil(left / 1000), WAIT_STEP_SECONDS)));
+        current = await project.awaitDecision(current.id, Math.max(1, Math.min(Math.ceil(left / 1000), WAIT_STEP_SECONDS)));
         if (current.answer === null) {
             await io.sleep(WAIT_PAUSE_MS);
         }
@@ -178,9 +194,9 @@ const stillWaiting = (id) => `Decision ${id} still waits for a person; the run w
  * Waits for the answer and says what it is, or that it is still to come. On `--json`, a decision
  * printed already as it was raised (`shown`) is printed again only with its answer.
  */
-async function settle(io, session, decision, seconds, shown = false) {
+async function settle(io, session, project, decision, seconds, shown = false) {
     const outcome = decision.answer === null && seconds > 0
-        ? await waitForAnswer(io, session.client, decision, seconds)
+        ? await waitForAnswer(io, project, decision, seconds)
         : decision;
     if (session.json) {
         if (!shown || outcome.answer !== null) {
@@ -212,7 +228,7 @@ const login = async (args, io) => {
         throw failed("The console does not know this token. Make one on your Tokens page and try again.");
     }
     const kept = await io.store.save({ url, token });
-    io.stdout(`Signed in to ${me.workspace.name} at ${url} as ${person.login} (${person.role}). The token is kept in ${kept}.\n`);
+    io.stdout(`Signed in to ${me.workspace.name} at ${url} as ${person.login} (${person.role}). The token is kept in ${kept}.\nNext, say which project this directory works in: console use <key> (console projects lists them).\n`);
     return EXIT.ok;
 };
 const logout = async (args, io) => {
@@ -229,21 +245,42 @@ const whoami = async (args, io) => {
     if (person === null) {
         throw failed("The console does not know this token. Sign in again: console login");
     }
-    answer(io, session, me, () => `${person.login} (${person.role}) at ${me.workspace.name}, ${session.url}`);
+    const key = await session.projectKey();
+    answer(io, session, { ...me, project: key ?? null }, () => `${person.login} (${person.role}) at ${me.workspace.name}, ${session.url}${key === undefined ? "; no project named here" : `; project ${key}`}`);
+    return EXIT.ok;
+};
+const projects = async (args, io) => {
+    const { values } = parse(args, {}, false);
+    const session = await open(io, values);
+    const found = await session.client.projects();
+    answer(io, session, found, () => found.items.length === 0
+        ? "No projects you may work in. A person makes one on the console's Projects page."
+        : found.items.map(formatProjectLine).join("\n"));
+    return EXIT.ok;
+};
+const use = async (args, io) => {
+    const { values, positionals } = parse(args, {});
+    const key = theOne(positionals, "Say which project: console use <key>");
+    const session = await open(io, values);
+    const project = await session.client.project(key).get();
+    const kept = await io.directory.save({ project: project.key });
+    answer(io, session, project, () => `Working in ${project.name} (${project.key}) from this directory on: kept in ${kept}, which is meant to be committed.`);
     return EXIT.ok;
 };
 const tasks = async (args, io) => {
     const { values } = parse(args, { state: { type: "string" } }, false);
     const state = stateOf(text(values, "state"));
     const session = await open(io, values);
-    const found = await session.client.tasks(state === undefined ? {} : { state });
+    const project = await session.project();
+    const found = await project.tasks(state === undefined ? {} : { state });
     answer(io, session, found, () => found.items.length === 0 ? "No tasks." : found.items.map(formatTaskLine).join("\n"));
     return EXIT.ok;
 };
 const skills = async (args, io) => {
     const { values } = parse(args, {}, false);
     const session = await open(io, values);
-    const found = await session.client.skills();
+    const project = await session.project();
+    const found = await project.skills();
     answer(io, session, found, () => formatSkills(found));
     return EXIT.ok;
 };
@@ -259,7 +296,8 @@ const newTask = async (args, io) => {
     const priority = priorityOf(text(values, "priority"));
     const body = await bodyOf(io, values, text(values, "body"));
     const session = await open(io, values);
-    const made = await session.client.createTask({
+    const project = await session.project();
+    const made = await project.createTask({
         title,
         ...(body === undefined ? {} : { body }),
         ...(state === undefined ? {} : { state }),
@@ -275,10 +313,11 @@ const task = async (args, io) => {
     const { values, positionals } = parse(args, {});
     const ref = theOne(positionals, "Say which task: console task <number|id>");
     const session = await open(io, values);
-    const found = await session.client.task(ref);
+    const project = await session.project();
+    const found = await project.task(ref);
     const [decisions, runs] = await Promise.all([
-        session.client.decisions({ task: found.id }),
-        session.client.runs({ task: found.id }),
+        project.decisions({ task: found.id }),
+        project.runs({ task: found.id }),
     ]);
     answer(io, session, { task: found, decisions: decisions.items, runs: runs.items }, () => formatTask(found, decisions.items, runs.items));
     return EXIT.ok;
@@ -287,9 +326,10 @@ const take = async (args, io) => {
     const { values, positionals } = parse(args, { agent: { type: "string" } });
     const ref = theOne(positionals, "Say which task: console take <number|id>");
     const session = await open(io, values);
-    const found = await session.client.task(ref);
+    const project = await session.project();
+    const found = await project.task(ref);
     const agent = text(values, "agent");
-    const run = await session.client.startRun({
+    const run = await project.startRun({
         taskId: found.id,
         ...(agent === undefined ? {} : { agent }),
     });
@@ -316,8 +356,9 @@ const report = async (args, io) => {
         throw misuse('Say what to report: console report "<markdown>", or --file <path>, or - to read standard input.');
     }
     const session = await open(io, values);
-    const runId = await currentRun(session, values);
-    const run = await session.client.report(runId, { body });
+    const project = await session.project();
+    const runId = await currentRun(project, values);
+    const run = await project.report(runId, { body });
     answer(io, session, run, () => `Reported on run ${run.id}: ${run.reports.length} report${run.reports.length === 1 ? "" : "s"} so far.`);
     return EXIT.ok;
 };
@@ -349,11 +390,12 @@ const handIn = async (args, io) => {
     const what = theOne(positionals, "Say what to hand in: console hand-in <https url | file path> [--label <words>]");
     const label = text(values, "label");
     const session = await open(io, values);
-    const runId = await currentRun(session, values);
+    const project = await session.project();
+    const runId = await currentRun(project, values);
     // A URL is handed in as a link, and the console says whether it takes it; anything else
     // names a file on this machine.
     if (/^[a-z][a-z0-9+.-]*:\/\//i.test(what)) {
-        const run = await session.client.handIn(runId, {
+        const run = await project.handIn(runId, {
             url: what,
             ...(label === undefined ? {} : { label }),
         });
@@ -369,7 +411,7 @@ const handIn = async (args, io) => {
     }
     const name = basename(what);
     const contentType = CONTENT_TYPES[extname(name).toLowerCase()];
-    const run = await session.client.handInFile(runId, {
+    const run = await project.handInFile(runId, {
         name,
         bytes,
         ...(contentType === undefined ? {} : { contentType }),
@@ -394,8 +436,9 @@ const ask = async (args, io) => {
     const seconds = secondsOf(text(values, "wait"), DEFAULT_ASK_WAIT_SECONDS);
     const body = await bodyOf(io, values, text(values, "body"));
     const session = await open(io, values);
-    const runId = await currentRun(session, values);
-    const raised = await session.client.raiseDecision({
+    const project = await session.project();
+    const runId = await currentRun(project, values);
+    const raised = await project.raiseDecision({
         question,
         options: options.map((label) => ({ label })),
         runId,
@@ -405,24 +448,26 @@ const ask = async (args, io) => {
     io.stdout(session.json
         ? `${JSON.stringify(raised, null, 2)}\n`
         : `Decision ${raised.id} raised on run ${runId}; the run waits for a person.\n${formatOptions(raised)}\n`);
-    return settle(io, session, raised, seconds, true);
+    return settle(io, session, project, raised, seconds, true);
 };
 const decision = async (args, io) => {
     const { values, positionals } = parse(args, { wait: { type: "string" } });
     const id = theOne(positionals, "Say which decision: console decision <id> [--wait <seconds>]");
     const seconds = secondsOf(text(values, "wait"), 0);
     const session = await open(io, values);
-    const found = await session.client.decision(id);
+    const project = await session.project();
+    const found = await project.decision(id);
     if (seconds === 0) {
         answer(io, session, found, () => formatDecision(found));
         return EXIT.ok;
     }
-    return settle(io, session, found, seconds);
+    return settle(io, session, project, found, seconds);
 };
 const decisions = async (args, io) => {
     const { values } = parse(args, { open: { type: "boolean" } }, false);
     const session = await open(io, values);
-    const found = await session.client.decisions(on(values, "open") ? { open: true } : {});
+    const project = await session.project();
+    const found = await project.decisions(on(values, "open") ? { open: true } : {});
     answer(io, session, found, () => found.items.length === 0 ? "No decisions." : found.items.map(formatDecisionLine).join("\n"));
     return EXIT.ok;
 };
@@ -430,8 +475,9 @@ const ending = (status) => async (args, io) => {
     const { values } = parse(args, { summary: { type: "string" }, file: { type: "string" }, run: { type: "string" } }, false);
     const summary = await bodyOf(io, values, text(values, "summary"));
     const session = await open(io, values);
-    const runId = await currentRun(session, values);
-    const run = await session.client.endRun(runId, {
+    const project = await session.project();
+    const runId = await currentRun(project, values);
+    const run = await project.endRun(runId, {
         status,
         ...(summary === undefined ? {} : { summary }),
     });
@@ -451,8 +497,9 @@ const abandon = async (args, io) => {
     }
     const summary = await bodyOf(io, values, text(values, "summary"));
     const session = await open(io, values);
-    const runId = positionals[0] ?? (await currentRun(session, values));
-    const run = await session.client.endRun(runId, {
+    const project = await session.project();
+    const runId = positionals[0] ?? (await currentRun(project, values));
+    const run = await project.endRun(runId, {
         status: "abandoned",
         ...(summary === undefined ? {} : { summary }),
     });
@@ -462,9 +509,10 @@ const abandon = async (args, io) => {
 const runs = async (args, io) => {
     const { values } = parse(args, { task: { type: "string" }, open: { type: "boolean" }, mine: { type: "boolean" } }, false);
     const session = await open(io, values);
+    const project = await session.project();
     const ref = text(values, "task");
-    const taskId = ref === undefined ? undefined : (await session.client.task(ref)).id;
-    const found = await session.client.runs({
+    const taskId = ref === undefined ? undefined : (await project.task(ref)).id;
+    const found = await project.runs({
         ...(taskId === undefined ? {} : { task: taskId }),
         ...(on(values, "open") ? { open: true } : {}),
         ...(on(values, "mine") ? { mine: true } : {}),
@@ -476,14 +524,17 @@ const run = async (args, io) => {
     const { values, positionals } = parse(args, {});
     const id = theOne(positionals, "Say which run: console run <id>");
     const session = await open(io, values);
-    const found = await session.client.run(id);
-    answer(io, session, found, () => formatRun(found));
+    const project = await session.project();
+    const found = await project.run(id);
+    answer(io, session, found, () => formatRun(found, (artifactId) => project.fileUrl(artifactId)));
     return EXIT.ok;
 };
 const COMMANDS = {
     login,
     logout,
     whoami,
+    projects,
+    use,
     tasks,
     task,
     skills,
@@ -501,7 +552,7 @@ const COMMANDS = {
 };
 function help(io, name) {
     if (name === undefined) {
-        io.stdout(usage());
+        io.stdout(usage(io.version));
         return EXIT.ok;
     }
     const found = helpFor(name);
@@ -516,6 +567,8 @@ function hintFor(error) {
     switch (error.code) {
         case "auth.required":
             return "The token is not one the console knows, any more or at all. A person signs the command in again: console login\n";
+        case "project.not_found":
+            return "No project has this key, or it is not yours to see. console projects lists the projects you may work in.\n";
         case "network":
             return "Is the console's address right? console whoami --url <origin> says what the command uses.\n";
         default:
@@ -526,6 +579,10 @@ function hintFor(error) {
 export async function runCli(argv, io) {
     const [name, ...rest] = argv;
     try {
+        if (name === "--version" || name === "-v" || name === "version") {
+            io.stdout(`console ${io.version ?? "(version unknown)"} (@skillcdn/console)\n`);
+            return EXIT.ok;
+        }
         if (name === undefined || name === "help" || name === "--help" || name === "-h") {
             return help(io, rest[0]);
         }