@toloka-platform/sdk 0.1.0-preview.9 → 0.2.0-preview.1

package/openapi/gen/models/trainingRunInputsAnyOfValidationAnyOfReportErrorsItem.ts

@@ -0,0 +1,5 @@
+
+export type TrainingRunInputsAnyOfValidationAnyOfReportErrorsItem = {
+  itemIndex: number;
+  reason: string;
+};

package/openapi/gen/models/trainingRunInputsAnyOfValidationAnyOfReportTokens.ts

@@ -0,0 +1,10 @@
+import type { TrainingRunInputsAnyOfValidationAnyOfReportTokensTotal } from './trainingRunInputsAnyOfValidationAnyOfReportTokensTotal';
+import type { TrainingRunInputsAnyOfValidationAnyOfReportTokensEstimatorVersion } from './trainingRunInputsAnyOfValidationAnyOfReportTokensEstimatorVersion';
+
+export type TrainingRunInputsAnyOfValidationAnyOfReportTokens = {
+  p50: number;
+  p95: number;
+  max: number;
+  total?: TrainingRunInputsAnyOfValidationAnyOfReportTokensTotal;
+  estimatorVersion?: TrainingRunInputsAnyOfValidationAnyOfReportTokensEstimatorVersion;
+};

package/openapi/gen/models/trainingRunInputsAnyOfValidationAnyOfReportTokensEstimatorVersion.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunInputsAnyOfValidationAnyOfReportTokensEstimatorVersion = 'utf16-code-units-div-4-v1' | null;

package/openapi/gen/models/trainingRunInputsAnyOfValidationAnyOfReportTokensTotal.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunInputsAnyOfValidationAnyOfReportTokensTotal = number | null;

package/openapi/gen/models/trainingRunLogs.ts

@@ -0,0 +1,9 @@
+import type { TrainingRunLogsEntriesItem } from './trainingRunLogsEntriesItem';
+import type { TrainingRunLogsNextCursor } from './trainingRunLogsNextCursor';
+
+export interface TrainingRunLogs {
+  entries: TrainingRunLogsEntriesItem[];
+  nextCursor: TrainingRunLogsNextCursor;
+  complete: boolean;
+  truncated: boolean;
+}

package/openapi/gen/models/trainingRunLogsEntriesItem.ts

@@ -0,0 +1,7 @@
+import type { TrainingRunLogsEntriesItemLevel } from './trainingRunLogsEntriesItemLevel';
+
+export type TrainingRunLogsEntriesItem = {
+  timestamp: string;
+  level: TrainingRunLogsEntriesItemLevel;
+  message: string;
+};

package/openapi/gen/models/trainingRunLogsEntriesItemLevel.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunLogsEntriesItemLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';

package/openapi/gen/models/trainingRunLogsNextCursor.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunLogsNextCursor = string | null;

package/openapi/gen/models/trainingRunMessage.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunMessage = string | null;

package/openapi/gen/models/trainingRunOutputModelVersionRevision.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunOutputModelVersionRevision = number | null;

package/openapi/gen/models/trainingRunProgress.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunProgressAnyOf } from './trainingRunProgressAnyOf';
+
+export type TrainingRunProgress = TrainingRunProgressAnyOf | null;

package/openapi/gen/models/trainingRunProgressAnyOf.ts

@@ -0,0 +1,10 @@
+import type { TrainingRunProgressAnyOfStep } from './trainingRunProgressAnyOfStep';
+import type { TrainingRunProgressAnyOfTotal } from './trainingRunProgressAnyOfTotal';
+import type { TrainingRunProgressAnyOfMessage } from './trainingRunProgressAnyOfMessage';
+
+export type TrainingRunProgressAnyOf = {
+  phase: string;
+  step: TrainingRunProgressAnyOfStep;
+  total: TrainingRunProgressAnyOfTotal;
+  message: TrainingRunProgressAnyOfMessage;
+};

package/openapi/gen/models/trainingRunProgressAnyOfMessage.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunProgressAnyOfMessage = string | null;

package/openapi/gen/models/trainingRunProgressAnyOfStep.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunProgressAnyOfStep = number | null;

package/openapi/gen/models/trainingRunProgressAnyOfTotal.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunProgressAnyOfTotal = number | null;

package/openapi/gen/models/trainingRunQuote.ts

@@ -0,0 +1,17 @@
+import type { TrainingCostEstimateInputSetId } from './trainingCostEstimateInputSetId';
+import type { TrainingRunQuoteInputs } from './trainingRunQuoteInputs';
+import type { TrainingRunQuoteBudget } from './trainingRunQuoteBudget';
+
+export type TrainingRunQuote = {
+  inputSetId: TrainingCostEstimateInputSetId;
+  cutoff: string;
+  inputs: TrainingRunQuoteInputs;
+  capabilityVersion: string;
+  pricingVersion: string;
+  calculatedAt: string;
+  budget: TrainingRunQuoteBudget;
+  basePricePerGpuHour: string;
+  marginMultiplier: string;
+  maximumCharge: string;
+  currency: 'USD';
+};

package/openapi/gen/models/trainingRunQuoteBudget.ts

@@ -0,0 +1,9 @@
+
+export type TrainingRunQuoteBudget = {
+  methodWorkUnits: number;
+  estimatedGpuSeconds: number;
+  estimatedWallSeconds: number;
+  maximumWallSeconds: number;
+  maximumGpuSeconds: number;
+  gpuCount: number;
+};

package/openapi/gen/models/trainingRunQuoteInputs.ts

@@ -0,0 +1,7 @@
+import type { TrainingRunQuoteInputsTraining } from './trainingRunQuoteInputsTraining';
+import type { TrainingRunQuoteInputsValidation } from './trainingRunQuoteInputsValidation';
+
+export type TrainingRunQuoteInputs = {
+  training: TrainingRunQuoteInputsTraining;
+  validation: TrainingRunQuoteInputsValidation;
+};

package/openapi/gen/models/trainingRunQuoteInputsTraining.ts

@@ -0,0 +1,9 @@
+import type { TrainingRunQuoteInputsTrainingReport } from './trainingRunQuoteInputsTrainingReport';
+import type { TrainingRunQuoteInputsTrainingFailure } from './trainingRunQuoteInputsTrainingFailure';
+
+export type TrainingRunQuoteInputsTraining = {
+  datasetId: string;
+  datasetExportId: string;
+  report: TrainingRunQuoteInputsTrainingReport;
+  failure: TrainingRunQuoteInputsTrainingFailure;
+};

package/openapi/gen/models/trainingRunQuoteInputsTrainingFailure.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunQuoteInputsTrainingFailureAnyOf } from './trainingRunQuoteInputsTrainingFailureAnyOf';
+
+export type TrainingRunQuoteInputsTrainingFailure = TrainingRunQuoteInputsTrainingFailureAnyOf | null;

package/openapi/gen/models/trainingRunQuoteInputsTrainingFailureAnyOf.ts

@@ -0,0 +1,7 @@
+import type { TrainingRunQuoteInputsTrainingFailureAnyOfCode } from './trainingRunQuoteInputsTrainingFailureAnyOfCode';
+
+export type TrainingRunQuoteInputsTrainingFailureAnyOf = {
+  timestamp: string;
+  code: TrainingRunQuoteInputsTrainingFailureAnyOfCode;
+  message: string;
+};

package/openapi/gen/models/trainingRunQuoteInputsTrainingFailureAnyOfCode.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsTrainingFailureAnyOfCode = 'empty_selection' | 'size_limit_exceeded' | 'assembly_failed';

package/openapi/gen/models/trainingRunQuoteInputsTrainingReport.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunQuoteInputsTrainingReportAnyOf } from './trainingRunQuoteInputsTrainingReportAnyOf';
+
+export type TrainingRunQuoteInputsTrainingReport = TrainingRunQuoteInputsTrainingReportAnyOf | null;

package/openapi/gen/models/trainingRunQuoteInputsTrainingReportAnyOf.ts

@@ -0,0 +1,9 @@
+import type { TrainingRunQuoteInputsTrainingReportAnyOfErrorsItem } from './trainingRunQuoteInputsTrainingReportAnyOfErrorsItem';
+import type { TrainingRunQuoteInputsTrainingReportAnyOfTokens } from './trainingRunQuoteInputsTrainingReportAnyOfTokens';
+
+export type TrainingRunQuoteInputsTrainingReportAnyOf = {
+  validCount: number;
+  invalidCount: number;
+  errors: TrainingRunQuoteInputsTrainingReportAnyOfErrorsItem[];
+  tokens: TrainingRunQuoteInputsTrainingReportAnyOfTokens;
+};

package/openapi/gen/models/trainingRunQuoteInputsTrainingReportAnyOfErrorsItem.ts

@@ -0,0 +1,5 @@
+
+export type TrainingRunQuoteInputsTrainingReportAnyOfErrorsItem = {
+  itemIndex: number;
+  reason: string;
+};

package/openapi/gen/models/trainingRunQuoteInputsTrainingReportAnyOfTokens.ts

@@ -0,0 +1,10 @@
+import type { TrainingRunQuoteInputsTrainingReportAnyOfTokensTotal } from './trainingRunQuoteInputsTrainingReportAnyOfTokensTotal';
+import type { TrainingRunQuoteInputsTrainingReportAnyOfTokensEstimatorVersion } from './trainingRunQuoteInputsTrainingReportAnyOfTokensEstimatorVersion';
+
+export type TrainingRunQuoteInputsTrainingReportAnyOfTokens = {
+  p50: number;
+  p95: number;
+  max: number;
+  total?: TrainingRunQuoteInputsTrainingReportAnyOfTokensTotal;
+  estimatorVersion?: TrainingRunQuoteInputsTrainingReportAnyOfTokensEstimatorVersion;
+};

package/openapi/gen/models/trainingRunQuoteInputsTrainingReportAnyOfTokensEstimatorVersion.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsTrainingReportAnyOfTokensEstimatorVersion = 'utf16-code-units-div-4-v1' | null;

package/openapi/gen/models/trainingRunQuoteInputsTrainingReportAnyOfTokensTotal.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsTrainingReportAnyOfTokensTotal = number | null;

package/openapi/gen/models/trainingRunQuoteInputsValidation.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunQuoteInputsValidationAnyOf } from './trainingRunQuoteInputsValidationAnyOf';
+
+export type TrainingRunQuoteInputsValidation = TrainingRunQuoteInputsValidationAnyOf | null;

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOf.ts

@@ -0,0 +1,9 @@
+import type { TrainingRunQuoteInputsValidationAnyOfReport } from './trainingRunQuoteInputsValidationAnyOfReport';
+import type { TrainingRunQuoteInputsValidationAnyOfFailure } from './trainingRunQuoteInputsValidationAnyOfFailure';
+
+export type TrainingRunQuoteInputsValidationAnyOf = {
+  datasetId: string;
+  datasetExportId: string;
+  report: TrainingRunQuoteInputsValidationAnyOfReport;
+  failure: TrainingRunQuoteInputsValidationAnyOfFailure;
+};

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfFailure.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunQuoteInputsValidationAnyOfFailureAnyOf } from './trainingRunQuoteInputsValidationAnyOfFailureAnyOf';
+
+export type TrainingRunQuoteInputsValidationAnyOfFailure = TrainingRunQuoteInputsValidationAnyOfFailureAnyOf | null;

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfFailureAnyOf.ts

@@ -0,0 +1,7 @@
+import type { TrainingRunQuoteInputsValidationAnyOfFailureAnyOfCode } from './trainingRunQuoteInputsValidationAnyOfFailureAnyOfCode';
+
+export type TrainingRunQuoteInputsValidationAnyOfFailureAnyOf = {
+  timestamp: string;
+  code: TrainingRunQuoteInputsValidationAnyOfFailureAnyOfCode;
+  message: string;
+};

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfFailureAnyOfCode.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsValidationAnyOfFailureAnyOfCode = 'empty_selection' | 'size_limit_exceeded' | 'assembly_failed';

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReport.ts

@@ -0,0 +1,3 @@
+import type { TrainingRunQuoteInputsValidationAnyOfReportAnyOf } from './trainingRunQuoteInputsValidationAnyOfReportAnyOf';
+
+export type TrainingRunQuoteInputsValidationAnyOfReport = TrainingRunQuoteInputsValidationAnyOfReportAnyOf | null;

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReportAnyOf.ts

@@ -0,0 +1,9 @@
+import type { TrainingRunQuoteInputsValidationAnyOfReportAnyOfErrorsItem } from './trainingRunQuoteInputsValidationAnyOfReportAnyOfErrorsItem';
+import type { TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokens } from './trainingRunQuoteInputsValidationAnyOfReportAnyOfTokens';
+
+export type TrainingRunQuoteInputsValidationAnyOfReportAnyOf = {
+  validCount: number;
+  invalidCount: number;
+  errors: TrainingRunQuoteInputsValidationAnyOfReportAnyOfErrorsItem[];
+  tokens: TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokens;
+};

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReportAnyOfErrorsItem.ts

@@ -0,0 +1,5 @@
+
+export type TrainingRunQuoteInputsValidationAnyOfReportAnyOfErrorsItem = {
+  itemIndex: number;
+  reason: string;
+};

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReportAnyOfTokens.ts

@@ -0,0 +1,10 @@
+import type { TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensTotal } from './trainingRunQuoteInputsValidationAnyOfReportAnyOfTokensTotal';
+import type { TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensEstimatorVersion } from './trainingRunQuoteInputsValidationAnyOfReportAnyOfTokensEstimatorVersion';
+
+export type TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokens = {
+  p50: number;
+  p95: number;
+  max: number;
+  total?: TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensTotal;
+  estimatorVersion?: TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensEstimatorVersion;
+};

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReportAnyOfTokensEstimatorVersion.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensEstimatorVersion = 'utf16-code-units-div-4-v1' | null;

package/openapi/gen/models/trainingRunQuoteInputsValidationAnyOfReportAnyOfTokensTotal.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunQuoteInputsValidationAnyOfReportAnyOfTokensTotal = number | null;

package/openapi/gen/models/trainingRunStatus.ts

@@ -0,0 +1,2 @@
+
+export type TrainingRunStatus = 'queued' | 'running' | 'stopping' | 'blocked' | 'completed' | 'failed' | 'canceled';

package/openapi/gen/models/updateTrainingMetadataBody.ts

@@ -0,0 +1,5 @@
+
+export type UpdateTrainingMetadataBody = {
+  name?: string;
+  archived?: boolean;
+};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@toloka-platform/sdk",
-  "version": "0.1.0-preview.9",
+  "version": "0.2.0-preview.1",
   "private": false,
-  "description": "Preview. Build, inspect, and operate Toloka pipeline projects as TypeScript source. The public API may change.",
+  "description": "Beta. Build, inspect, and operate Toloka pipeline projects as TypeScript source. The public API may change.",
   "license": "Apache-2.0",
   "bin": {
     "toloka": "bin/toloka.js"
@@ -28,7 +28,7 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/",
-    "tag": "preview"
+    "tag": "latest"
   },
   "scripts": {
     "build": "bun ./scripts/build-cli.ts ./dist/cli",

package/skills/catalog.json

@@ -13,18 +13,30 @@
         "testing",
         "checks"
       ],
-      "version": "0.1.0-preview.9",
-      "digest": "87dca7b1cc0cf3d61f54ab27703ea4b60622355ec07e289ce1242bb3c2233482",
-      "files": ["SKILL.md", "references/node-semantics.md", "references/workflow-and-cli.md"]
+      "version": "0.2.0-preview.1",
+      "digest": "5e5bdd01d1f87d2de65af6ac4d7c3f48f1e79e62355a5e3774a9e205c21fbf2c",
+      "files": [
+        "SKILL.md",
+        "references/node-semantics.md",
+        "references/workflow-and-cli.md"
+      ]
     },
     {
       "id": "toloka-report-issue",
       "name": "Report a Toloka problem",
       "description": "Report a problem with the Toloka platform, CLI, or SDK as a redacted Markdown issue report sent through the toloka CLI only after explicit approval. Use when the user hits unexpected behavior, an error, or a bug and wants Toloka engineers to investigate.",
-      "tags": ["support", "issue", "bug", "report"],
-      "version": "0.1.0-preview.9",
-      "digest": "6fb8ccf80b346de0745bb7d9192e4e3998cb8f06c8b30f7eb6dcc5b326f4646d",
-      "files": ["SKILL.md", "references/report-template.md"]
+      "tags": [
+        "support",
+        "issue",
+        "bug",
+        "report"
+      ],
+      "version": "0.2.0-preview.1",
+      "digest": "c4743435270c6fee22b230eab8ac1ef642262a94e960ada91f9bba5894eb03b5",
+      "files": [
+        "SKILL.md",
+        "references/report-template.md"
+      ]
     }
   ]
 }

package/skills/toloka-build/SKILL.md

@@ -5,13 +5,13 @@ description: Onboard users and build, test, inspect, or change Toloka platform p
 
 # Build Toloka pipelines as code
 
-This SDK is Preview software. The authoring API, the CLI, and generated source can change. Do not invent helpers or flags that are not in the installed package.
+This SDK is Beta software. The authoring API, the CLI, and generated source can change before general availability. Do not invent helpers or flags that are not in the installed package.
 
 Use this skill when the user wants to get started or to create, inspect, test, or change a Toloka pipeline project as code. Work in the project source tree; do not translate the request into direct platform API calls.
 
 ## Guide a first-time user
 
-When the user asks to get started or points to `https://platform.toloka.ai/onboarding.md`, read that guide before acting. The guide owns the session order and its user checkpoints. This skill owns authoring semantics, local test requirements, recovery, and evidence reporting.
+When the user asks to get started or points to `https://platform.toloka.ai/agents/data-labeling.md`, read that guide before acting. The guide owns the session order and its user checkpoints. This skill owns authoring semantics, local test requirements, recovery, and evidence reporting.
 
 Do not replace the guide's quick demo with another example, and do not run the demo when the user chooses their own task. Never cross its API-key, project-creation, plan, or run-cost checkpoint without the user's required action or approval.
 
@@ -75,7 +75,7 @@ These are server rules that `definePipeline` does not check. Each one costs an a
 
 `toloka check` is the required local gate. It runs the project TypeScript compiler, typechecks every authored Task UI against declarations bundled with this SDK version, runs Vitest, and requires passing typed `test.code`, `test.ui`, and `test.pipeline` evidence for every checkable node and pipeline. Use `toloka check <pipeline> --node <name-or-id>` while iterating, then run the unfiltered command before plan or run. Status `missing` means required test evidence does not exist; `failed` means a check ran and failed; `partial` means hardware-backed behavior remains unverified; `infrastructure_error` means the checker could not run. All four block apply.
 
-`toloka validate` posts each bound graph to the platform. Treat source/spec errors as blocking and warnings as informational. `not_ran_node_check` concerns a separate Remote Node Check and does not invalidate a passing Local Check Gate. A pipeline not yet on the platform is skipped until `toloka apply` creates it. When a reviewed plan adds a dataset field already bound by an existing live pipeline, pre-apply validation can report that exact field as missing; apply only the reviewed additive plan, then require post-apply validation to clear source/spec errors. Never rewrite valid source for a missing Remote Node Check.
+`toloka validate` posts each bound graph to the platform. Treat source/spec errors as blocking and warnings as informational. A `not_ran_node_check` concerns a separate Remote Node Check and does not replace a passing Local Check Gate, but its remote-validation severity still matters: lint checks report it as a blocking error while other checks can report it as a warning. A pipeline not yet on the platform is skipped until `toloka apply` creates it. When a reviewed plan adds a dataset field already bound by an existing live pipeline, pre-apply validation can report that exact field as missing; apply only the reviewed additive plan, then require post-apply validation to clear source/spec errors. Never rewrite valid source for a missing Remote Node Check.
 
 Before choosing Task UI components, call `ui.componentDocumentation()` from a local `@toloka-platform/sdk/testing` scenario. A component's usable contract is the returned `propsType` plus its returned `valueType` and `example`; shared `Field` props such as `path`, `label`, `hint`, and `validation` can be confirmed from any current `Field.*` example, but do not invent any other prop. For structured or array-valued Fields, derive the dataset field schema from `valueType`, then feed the documented example value through `setValue`, `getValue`, and `submit` in the UI scenario so upstream contract drift fails locally. Never translate undocumented property names or replace missing values with defaults. Every identifier in `ui.code` must be a returned component or documented `actions` API, and JSX must have one root element. Register each required UI scenario with `test.ui(pipeline, node, name, callback)` and submit through its bound `render` helper. Run `toloka check <pipeline> --node <name-or-id>` after every Task UI edit; require passing UI types, empty browser validation errors, valid postprocessed entity output, and visual inspection where relevant. Never weaken authored validation merely to make a test pass.
 
@@ -104,7 +104,7 @@ A globally installed CLI auto-updates by default; turn that off with `toloka con
 
 ## Run a deployed pipeline
 
-Before starting a run, require a passing `toloka check` and no blocking source/spec error from `toloka validate`. Do not block on `not_ran_node_check`, which concerns separate Remote Node Checks. Run `toloka pipeline cost <name>` when pricing evidence is needed; if it skips a billed node, report the authored rate and a labeled labor floor instead of presenting `$0.00` as the price.
+Before starting a run, require a passing `toloka check` and no blocking error from `toloka validate`. A warning-severity `not_ran_node_check` concerns a separate Remote Node Check and does not block the Local Check Gate; an error-severity instance remains a blocking remote-validation result. Run `toloka pipeline cost <name>` when pricing evidence is needed; if it skips a billed node, report the authored rate and a labeled labor floor instead of presenting `$0.00` as the price.
 
 Start a run with `toloka pipeline run <name> --wait --timeout <ms>`, then read its exit code: `0` succeeded, `1` reached a failed terminal state, `2` still running when the window closed. Without `--wait`, exit `0` only means the run was accepted. Nothing reports back later, so never describe a started run as a finished one. Name the live pipeline; there is no implicit only-pipeline.
 

package/skills/toloka-build/references/node-semantics.md

@@ -43,13 +43,13 @@ connect(annotate.output, collection.completed);
 
 ### Pick and configure it
 
-Create exactly one `root` node. Use `started` for dataset fields the pipeline reads and `completed` for fields it writes back to the same dataset. A completed field is not a separate output destination: the platform creates or uses that dataset column per item.
+Create exactly one `root` node with `root(settings)`. It has no name argument because it represents the pipeline boundary, not a named unit of work. Use `started` for dataset fields the pipeline reads and `completed` for fields it writes back to the same dataset. A completed field is not a separate output destination: the platform creates or uses that dataset column per item.
 
 The public authoring shape is `RootAuthoringSettings`:
 
 - `started`: fields exposed through the `started` output port.
 - `completed`: fields accepted through the `completed` input port and written to the dataset.
-- Each entry can be a `Field` or `{ field, optional }`; a bare `Field` is required.
+- Each entry can be a required `Field`, `optional(field)`, or an explicit `{ field, optional }` binding. Prefer `optional(field)` for new optional bindings and preserve the explicit object form in imported source.
 - `itemLimit` exists in both `RootNodeSettings` and `RootAuthoringSettings`. Do not invent a limit; author one only when the user explicitly requests a bounded test or batch. Apply preserves a live `itemLimit` unless source declares its own.
 
 The dataset name belongs in `definePipeline({ dataset: 'name', ... })`, not in the root settings. `toloka apply` resolves or creates the named dataset and supplies its ID.

package/skills/toloka-build/references/workflow-and-cli.md

@@ -26,7 +26,7 @@ Treat the three layers differently:
 
 ## Initialize the source root
 
-For a first-time guided session, read `https://platform.toloka.ai/onboarding.md` first. Keep its stage order and checkpoints; use this reference for the commands and source-first invariants inside those stages.
+For a first-time guided session, read `https://platform.toloka.ai/agents/data-labeling.md` first. Keep its stage order and checkpoints; use this reference for the commands and source-first invariants inside those stages.
 
 Install the SDK before invoking project commands:
 
@@ -83,7 +83,7 @@ All commands accept `--source-root <directory>`. Prefer running from the source
 The real command surface is:
 
 ```text
-toloka version
+toloka version [--json]
 toloka -v
 toloka --version
 toloka login
@@ -99,6 +99,7 @@ toloka project current
 toloka project url
 toloka project remove <alias>
 toloka project create [alias] [--name <name>] [--team-id <id>]
+toloka project untrack <pipeline|dataset> <name> [--confirm]
 toloka init
 toloka import [projectId]
 toloka check [pipeline] [--node <name-or-id>] [--json] [--watch]
@@ -125,6 +126,17 @@ toloka model get <name-or-id> [--json]
 toloka model versions <name-or-id> [--json]
 toloka model create <name> --base <base-model-id> [--description <text>] [--json]
 toloka model archive <name-or-id> [--json]
+toloka training list [--json]
+toloka training get <name-or-id> [--json]
+toloka training create <name> (--base-model <id> | --model-version <id>) --dataset <id> [--json]
+toloka training update <name-or-id> [configuration flags] [--json]
+toloka training cost <name-or-id> [--idempotency-key <key>] [--json]
+toloka training run <name-or-id> --estimate-file <path> --version-name <name> [--idempotency-key <key>] [--json]
+toloka training runs <name-or-id> [--json]
+toloka training status <training-run-id> [--json]
+toloka training resume <training-run-id> [--json]
+toloka training cancel <training-run-id> [--json]
+toloka training logs <training-run-id> [--follow]
 toloka skill list [--json]
 toloka skill search <query> [--json]
 toloka skill install <skill-id> [--force]
@@ -141,6 +153,12 @@ Select the platform project with `toloka project add` or `toloka project create`
 
 The global Base Model Catalog is read-only and uses `toloka base-model`. `base-model list` prints aligned ID, name, provider, and upstream-model columns by default. `toloka model` manages project-owned lineages; creation requires one catalog `baseModelId` and creates metadata without a Model Version. Every Base Model and Model command accepts `--json` for machine-readable output. Model Version upload, validation, and download commands are deferred until the separate upload-processing contract is implemented.
 
+## Train a model
+
+`toloka training create` requires one source (`--base-model` or `--model-version`) and a training Dataset. The output Model is created on the first Training Run from the Training name, or bound from an existing Model Version source.
+
+Use `training cost` to validate inputs and produce a ready estimate JSON file before `training run`. The run command requires that file and an explicit maximum cost. Use `training status`, `training logs`, `training resume`, and `training cancel` with the returned Training Run ID.
+
 ## Adopt an existing live project
 
 1. Install `@toloka-platform/sdk` in the intended source root.
@@ -180,7 +198,7 @@ toloka validate
 
 With `--watch --json`, each completed rerun writes one JSON line. Do not start another watcher while one is active.
 
-`toloka validate` posts each authored graph to the platform. Distinguish source/spec errors, which require source changes; `not_ran_node_check`, which describes a separate Remote Node Check; and warnings. It does not write the graph. A pipeline that is not on the platform yet is skipped until `toloka apply` creates it. When plan adds a dataset field used by an already-live pipeline, pre-apply validation can report that exact field as `misconfigured_node_form_component` because the column is not live yet. Treat it as expected only when the reviewed plan adds the same field, then require post-apply validation to clear the source/spec error.
+`toloka validate` posts each authored graph to the platform. Distinguish source/spec errors, which require source changes; Remote Node Check state; and warnings. A lint `not_ran_node_check` is a blocking remote-validation error, while other check types can report the same code as a warning; neither replaces the Local Check Gate. Validation does not write the graph. A pipeline that is not on the platform yet is skipped until `toloka apply` creates it. When plan adds a dataset field used by an already-live pipeline, pre-apply validation can report that exact field as `misconfigured_node_form_component` because the column is not live yet. Treat it as expected only when the reviewed plan adds the same field, then require post-apply validation to clear the source/spec error.
 
 The authored API still supplies extra local safety:
 

package/skills/toloka-report-issue/references/report-template.md

@@ -26,7 +26,7 @@ The CLI exits 1 with `Potato API request failed with status 500`. The same comma
 
 ## Environment
 
-- toloka CLI 0.1.0-preview.9 (`toloka --version`), Bun 1.4.0, macOS 15
+- toloka CLI 0.2.0-preview.1 (`toloka --version`), Bun 1.4.0, macOS 15
 - Platform: https://platform.toloka.ai
 
 ## Redactions

package/src/authoring/index.ts

@@ -56,6 +56,8 @@ type FieldReference = {
   readonly optional: boolean;
 };
 
+export type OptionalFieldBinding = { readonly field: Field; readonly optional: true };
+
 type RootFieldReference = Field | { readonly field: Field; readonly optional?: boolean };
 
 type FieldRelation<Relation> = Relation extends { id: string }
@@ -445,10 +447,18 @@ export function field<const Name extends string>(
   };
 }
 
+export function optional(referencedField: Field): OptionalFieldBinding {
+  return { field: referencedField, optional: true };
+}
+
 function createRoot(
   settings: RootAuthoringSettings,
   options: AuthoringIdOptions = {},
 ): AuthoredRootNode {
+  assert(
+    typeof settings === "object" && settings !== null && !Array.isArray(settings),
+    "root() defines the single pipeline boundary; call root({ started, completed }) without a name",
+  );
   const id = options.id ?? "root";
   const { started, completed, ...settingsWithoutFieldProxies } = settings;
   return {

package/src/cli/auth.ts

@@ -81,7 +81,7 @@ export async function login(options: LoginOptions = {}): Promise<LoginResult> {
       PRODUCTION_BASE_URL,
   );
 
-  let apiKey = options.apiKey;
+  let apiKey = options.apiKey ?? environment.POTATO_API_KEY;
   if (apiKey === undefined) {
     assert(
       options.prompt,

package/src/cli/auto-update.ts

@@ -123,11 +123,7 @@ export const asNpmPackageView = (payload: unknown): NpmPackageView | undefined =
 };
 
 export const latestPublishedVersion = (view: NpmPackageView): string | undefined => {
-  const tags = view["dist-tags"];
-  if (tags === undefined) return undefined;
-  const preview = tags.preview;
-  if (typeof preview === "string" && preview.length > 0) return preview;
-  const latest = tags.latest;
+  const latest = view["dist-tags"]?.latest;
   return typeof latest === "string" && latest.length > 0 ? latest : undefined;
 };
 

package/src/cli/bin.ts

@@ -1,4 +1,4 @@
 #!/usr/bin/env bun
-import { runTolokaCli } from './program';
+import { runTolokaCli } from "./program";
 
 process.exitCode = await runTolokaCli(process.argv.slice(2));