@toloka-platform/sdk 0.1.0 → 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,6 +1,6 @@
 {
   "name": "@toloka-platform/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0-preview.1",
   "private": false,
   "description": "Beta. Build, inspect, and operate Toloka pipeline projects as TypeScript source. The public API may change.",
   "license": "Apache-2.0",

package/skills/catalog.json

@@ -13,18 +13,30 @@
         "testing",
         "checks"
       ],
-      "version": "0.1.0",
-      "digest": "bcdb60e89bc4b8e345c1793c7a7d5275e8b196e171bd09adba242ed89f117a50",
-      "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",
-      "digest": "969aedef68e56243395e0a9115d90041c7c1e27f759762b07e62a7d521a8a251",
-      "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

@@ -11,7 +11,7 @@ Use this skill when the user wants to get started or to create, inspect, test, o
 
 ## 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/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:
 
@@ -126,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]
@@ -142,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.
@@ -181,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 (`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/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/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));

package/src/cli/cost.ts

@@ -88,7 +88,7 @@ const collectTotalRows = (total: PipelineCostEstimate["total"]): TableRow[] => {
           ["Maximum run cost", "", total.worstCase],
         ];
   if (total.bestCase != null) {
-    totals.push(["Best case", total.bestCase, ""]);
+    totals.push(["Best case", total.bestCase, "N/A"]);
   }
   if (total.perItemExpected != null) {
     totals.push(["Per item", total.perItemExpected, total.perItemWorstCase ?? ""]);

package/src/cli/models.ts

@@ -1,3 +1,10 @@
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { mkdir, open, realpath, rename, rm } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { Readable, Transform } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
 import { assert } from "es-toolkit";
 
 import type { BaseModel, BaseModelId, Model, ModelVersion, PotatoClient } from "../client";
@@ -73,6 +80,29 @@ const resolveModel = async (
   return matches[0]!;
 };
 
+const resolveModelVersion = async (
+  client: ModelApi,
+  projectId: string | undefined,
+  nameOrId: string,
+): Promise<ModelVersion> => {
+  if (nameOrId.startsWith("mdv.")) return client.models.getVersion({ modelVersionId: nameOrId });
+  const separator = nameOrId.lastIndexOf("@");
+  assert(separator > 0, `Model Version ${nameOrId} was not found. Use mdv.<id> or Model@name.`);
+  assert(projectId, "Select a project to resolve Model Version names.");
+  const model = await resolveModel(client, projectId, nameOrId.slice(0, separator));
+  const versionName = nameOrId.slice(separator + 1);
+  const matches: ModelVersion[] = [];
+  for await (const version of client.models.listAllVersions({
+    projectId,
+    modelId: model.id,
+    limit: 100,
+  })) {
+    if (version.name === versionName) matches.push(version);
+  }
+  assert(matches.length === 1, `Model Version ${nameOrId} was not found or is ambiguous.`);
+  return matches[0]!;
+};
+
 export const listBaseModels = async (
   client: ModelApi,
   input: { json: boolean },
@@ -155,8 +185,13 @@ export const listModelVersions = async (
     versions.length === 0
       ? "No Model Versions found."
       : formatTable([
-          ["VERSION", "ID", "CREATED AT"],
-          ...versions.map((version) => [version.version, version.id, version.createdAt]),
+          ["REVISION", "NAME", "ID", "CREATED AT"],
+          ...versions.map((version) => [
+            String(version.revision),
+            version.name,
+            version.id,
+            version.createdAt,
+          ]),
         ]),
   );
 };
@@ -186,3 +221,73 @@ export const archiveModel = async (
   const archived = await client.models.archive({ projectId: input.projectId, modelId: model.id });
   writeOutput(io, input.json, archived, `Archived Model ${archived.id}.`);
 };
+
+export const downloadModelVersion = async (
+  client: ModelApi,
+  input: { projectId?: string; modelVersionId: string; out: string },
+  io: ModelIo,
+): Promise<void> => {
+  const version = await resolveModelVersion(client, input.projectId, input.modelVersionId);
+  const descriptor = await client.models.getVersionContent({
+    modelVersionId: version.id,
+  });
+  const root = resolve(input.out);
+  await mkdir(root, { recursive: true });
+  const realRoot = await realpath(root);
+
+  for (const file of descriptor.files) {
+    const target = resolve(root, file.path);
+    const relativeTarget = relative(root, target);
+    assert(
+      relativeTarget !== "" &&
+        relativeTarget !== ".." &&
+        !relativeTarget.startsWith(`..${sep}`) &&
+        !isAbsolute(relativeTarget),
+      `Invalid Model Version file path: ${file.path}`,
+    );
+    let parent = root;
+    for (const segment of file.path.split("/").slice(0, -1)) {
+      parent = resolve(parent, segment);
+      await mkdir(parent, { recursive: true });
+      const realParent = await realpath(parent);
+      assert(
+        realParent === realRoot || realParent.startsWith(`${realRoot}${sep}`),
+        `Invalid Model Version file path: ${file.path}`,
+      );
+    }
+    const response = await fetch(file.url, { redirect: "error" });
+    assert(response.ok && response.body, `Failed to download Model Version file ${file.path}.`);
+    const hash = createHash("sha256");
+    let byteSize = 0;
+    const verify = new Transform({
+      transform(chunk: Buffer, _encoding, callback) {
+        byteSize += chunk.byteLength;
+        hash.update(chunk);
+        callback(null, chunk);
+      },
+    });
+    const temporary = `${target}.${randomUUID()}.tmp`;
+    try {
+      const handle = await open(
+        temporary,
+        constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW,
+        0o600,
+      );
+      await pipeline(Readable.from(response.body), verify, handle.createWriteStream());
+      assert(
+        byteSize === file.byteSize,
+        `Downloaded Model Version file ${file.path} has an unexpected size.`,
+      );
+      assert(
+        hash.digest("hex") === file.sha256,
+        `Downloaded Model Version file ${file.path} has an invalid hash.`,
+      );
+      await rename(temporary, target);
+    } catch (error) {
+      await rm(temporary, { force: true });
+      throw error;
+    }
+  }
+
+  io.stdout(`Downloaded Model Version ${descriptor.id} revision ${descriptor.revision} to ${root}`);
+};