@toloka-platform/sdk 0.2.1 → 0.3.0

package/README.md

@@ -43,21 +43,23 @@ toloka init
 
 ## Install
 
-Install the bytecode-cached CLI and add the stable SDK to the project:
+Install the CLI:
 
 ```sh
 curl -fsSL https://platform.toloka.ai/cli/install.sh | sh
-bun add @toloka-platform/sdk@latest
+toloka --version
 ```
 
-The installer requires Bun 1.4.0 or newer, installs `@toloka-platform/sdk` globally, and exposes `toloka` through Bun's global binary directory. The project install makes SDK imports resolvable.
+The installer uses compatible Bun when available, otherwise installs a standalone executable with its runtime included. See [CLI setup](./docs/cli.md#install) for `--bun` / `--native`, supported platforms, PATH, and updates.
 
-`latest` currently resolves to stable `0.2.0`. It includes Training (`toloka training`), the agent runbooks, and their bundled skills. For a reproducible project install, pin the current stable version:
+**Bun is the recommended runtime and package manager for SDK development.** Add the SDK when authoring pipelines:
 
 ```sh
-bun add @toloka-platform/sdk@0.2.0
+bun add @toloka-platform/sdk@latest
 ```
 
+For an existing project, run `bun i` to install its dependencies. Training-only workflows need neither the SDK nor a separate runtime. See [Getting started](./docs/getting-started.md) for the full authoring workflow.
+
 For a guided first run, start a fresh coding-agent session and ask it to follow the [Toloka agent bootstrap](https://platform.toloka.ai/agents/SKILL.md). It routes to the data-labeling, fine-tuning, or gisting runbook and the matching packaged skill.
 
 ## Documentation
@@ -93,9 +95,13 @@ Two rules the platform enforces and the SDK will not paper over:
 - **Dataset columns are immutable.** A column can be added, never altered, never removed. `plan` reports a schema conflict and `apply` refuses rather than rewriting data.
 - **Nothing is deleted implicitly.** A pipeline or dataset that exists live but not in source is reported and refused, not dropped.
 
+## Authenticate the client from code
+
+`createClient` takes the platform URL and one credential. `{ baseUrl, apiKey }` sends the key with the `ApiKey` authorization scheme on every request; the key does not expire until it is deleted in the Business Console. `{ baseUrl, accessToken }` calls the `accessToken` function before every request and sends its result as a Bearer token, so a renewable session can back the client. The two forms are exclusive. The CLI uses the second form for its browser sign-in.
+
 ## Agent support
 
-`toloka init` initializes the current directory with one managed `<toloka>` Agent Bootstrap block in `AGENTS.md` plus minimal pointers to it: a Claude skill at `.claude/skills/toloka-bootstrap/SKILL.md` and, when `.cursor/rules/` exists, an always-applied Cursor rule at `.cursor/rules/toloka-bootstrap.mdc`. It does not bind a checkout from the machine registry's current project. Pass `--project-id`, set `TOLOKA_PROJECT_ID`, or run `toloka project create` first when `init` must write `toloka.json`. For an existing project, run `toloka import <projectId>` before `init`. Re-running `init` refreshes only SDK-owned content and removes only Toloka-generated legacy entry points. Then open your coding agent in that directory and ask it to create the project you need; the bootstrap directs the agent to `toloka --help`, skill discovery, and the installed skill.
+`toloka init` initializes the current directory with one managed `<toloka>` Agent Bootstrap block in `AGENTS.md` plus minimal pointers to it: a Claude skill at `.claude/skills/toloka-bootstrap/SKILL.md` and, when `.cursor/rules/` exists, an always-applied Cursor rule at `.cursor/rules/toloka-bootstrap.mdc`. It does not bind a checkout from the machine registry's current project. Pass `--project-id`, set `TOLOKA_PROJECT_ID`, or run `toloka project create` first when `init` must write `toloka.json`. For an existing project, run `toloka import <projectId>` before `init`. Re-running `init` refreshes only CLI-owned content and removes only Toloka-generated legacy entry points; run it again after updating the standalone CLI. Then open your coding agent in that directory and ask it to create the project you need; the bootstrap directs the agent to `toloka --help`, skill discovery, and the installed skill.
 
 ## Agent evals