@toloka-platform/sdk 0.1.0-preview.4 → 0.1.0-preview.6

package/openapi/gen/models/baseModel.ts

@@ -0,0 +1,9 @@
+import type { BaseModelIdProperty } from './baseModelIdProperty';
+
+export interface BaseModel {
+  id: BaseModelIdProperty;
+  displayName: string;
+  provider: string;
+  upstreamModel: string;
+  upstreamRevision: string;
+}

package/openapi/gen/models/baseModelId.ts

@@ -0,0 +1,2 @@
+
+export type BaseModelId = 'qwen3-4b' | 'qwen3-8b' | 'qwen3-32b' | 'qwen3-235b';

package/openapi/gen/models/baseModelIdProperty.ts

@@ -0,0 +1,2 @@
+
+export type BaseModelIdProperty = 'qwen3-4b' | 'qwen3-8b' | 'qwen3-32b' | 'qwen3-235b';

package/openapi/gen/models/createDatasetBody.ts

@@ -1,4 +1,6 @@
+import type { CreateDatasetBodyProfile } from './createDatasetBodyProfile';
 
 export type CreateDatasetBody = {
   name?: string;
+  profile?: CreateDatasetBodyProfile;
 };

package/openapi/gen/models/createDatasetBodyProfile.ts

@@ -0,0 +1,2 @@
+
+export type CreateDatasetBodyProfile = 'chat-sft' | 'instruction';

package/openapi/gen/models/createDatasetUploadBodyFormat.ts

@@ -1,2 +1,2 @@
 
-export type CreateDatasetUploadBodyFormat = 'json' | 'csv';
+export type CreateDatasetUploadBodyFormat = 'json' | 'csv' | 'jsonl';

package/openapi/gen/models/createProjectModelBody.ts

@@ -0,0 +1,8 @@
+import type { CreateProjectModelBodyDescription } from './createProjectModelBodyDescription';
+import type { BaseModelId } from './baseModelId';
+
+export type CreateProjectModelBody = {
+  name: string;
+  description?: CreateProjectModelBodyDescription;
+  baseModelId: BaseModelId;
+};

package/openapi/gen/models/createProjectModelBodyDescription.ts

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

package/openapi/gen/models/dataset.ts

@@ -1,10 +1,12 @@
 import type { DatasetId } from './datasetId';
 import type { ProjectId } from './projectId';
+import type { DatasetProfile } from './datasetProfile';
 
 export interface Dataset {
   id: DatasetId;
   projectId: ProjectId;
   name: string;
   hidden: boolean;
+  profile: DatasetProfile;
   createdAt: string;
 }

package/openapi/gen/models/datasetProfile.ts

@@ -0,0 +1,3 @@
+import type { DatasetProfileStamp } from './datasetProfileStamp';
+
+export type DatasetProfile = DatasetProfileStamp | null;

package/openapi/gen/models/datasetProfileStamp.ts

@@ -0,0 +1,6 @@
+import type { DatasetProfileStampName } from './datasetProfileStampName';
+
+export interface DatasetProfileStamp {
+  name: DatasetProfileStampName;
+  version: number;
+}

package/openapi/gen/models/datasetProfileStampName.ts

@@ -0,0 +1,2 @@
+
+export type DatasetProfileStampName = 'chat-sft' | 'instruction';

package/openapi/gen/models/generationNodeSettingsAudienceAndPricingOneOfOneone.ts

@@ -6,4 +6,5 @@ export type GenerationNodeSettingsAudienceAndPricingOneOfOneone = {
   generationModelId?: GenerationNodeSettingsAudienceAndPricingOneOfOneoneGenerationModelId;
   reasoningEffort?: GenerationNodeSettingsAudienceAndPricingOneOfOneoneReasoningEffort;
   llmInstruction?: string;
+  maxCostPerAttempt: number;
 };

package/openapi/gen/models/index.ts

@@ -19,6 +19,9 @@ export * from './attachPipelineDatasetBodyItemFilterFieldValuesItemSourcesItem';
 export * from './attachPipelineDatasetBodyItemFilterFieldValuesItemSourcesItemOneOf';
 export * from './attachPipelineDatasetBodyItemFilterFieldValuesItemSourcesItemOneOfTwo';
 export * from './attachPipelineDatasetBodyItemFilterFieldValuesItemValue';
+export * from './baseModel';
+export * from './baseModelId';
+export * from './baseModelIdProperty';
 export * from './checkJob';
 export * from './checkJobError';
 export * from './checkJobResult';
@@ -68,6 +71,7 @@ export * from './codeNodeSettingsFieldProxiesInputItem';
 export * from './codeNodeSettingsFieldProxiesOutputItem';
 export * from './copyPipelineBody';
 export * from './createDatasetBody';
+export * from './createDatasetBodyProfile';
 export * from './createDatasetExportBody';
 export * from './createDatasetField200';
 export * from './createDatasetFieldBody';
@@ -95,6 +99,8 @@ export * from './createProjectBody';
 export * from './createProjectBodyDeliveryOrderId';
 export * from './createProjectFileUpload200';
 export * from './createProjectFileUploadBody';
+export * from './createProjectModelBody';
+export * from './createProjectModelBodyDescription';
 export * from './createdDatasetFields';
 export * from './currentUser';
 export * from './currentUserEmail';
@@ -111,6 +117,9 @@ export * from './datasetItem';
 export * from './datasetItemCurrentSubmissionId';
 export * from './datasetItemDuplicateOfSubmissionId';
 export * from './datasetItemId';
+export * from './datasetProfile';
+export * from './datasetProfileStamp';
+export * from './datasetProfileStampName';
 export * from './estimatePipelineCostBody';
 export * from './estimatePipelineCostBodyItemFilter';
 export * from './estimatePipelineCostBodyItemFilterFieldSourcesItem';
@@ -245,10 +254,13 @@ export * from './jsonSchema';
 export * from './jsonSchemaAdditionalProperties';
 export * from './jsonSchemaType';
 export * from './jsonSchemaTypeAnyOfItem';
+export * from './listBaseModels200';
 export * from './listDatasetFields200';
 export * from './listDatasetFieldsParams';
 export * from './listDatasetItems200';
 export * from './listDatasetItemsParams';
+export * from './listModelVersions200';
+export * from './listModelVersionsParams';
 export * from './listPipelineChecks200';
 export * from './listPipelineRunItems200';
 export * from './listPipelineRunItemsParams';
@@ -257,6 +269,8 @@ export * from './listPipelineRunsParams';
 export * from './listProjectDatasets200';
 export * from './listProjectDatasetsParams';
 export * from './listProjectFiles200';
+export * from './listProjectModels200';
+export * from './listProjectModelsParams';
 export * from './listProjectPipelines200';
 export * from './listProjectPipelinesParams';
 export * from './listProjectSecrets200';
@@ -273,6 +287,12 @@ export * from './matchNodeSettingsConditionsItemPredicatesItemOperator';
 export * from './matchNodeSettingsConditionsItemPredicatesItemValue';
 export * from './matchNodeSettingsFieldProxies';
 export * from './matchNodeSettingsFieldProxiesInputItem';
+export * from './model';
+export * from './modelArchivedAt';
+export * from './modelDescription';
+export * from './modelId';
+export * from './modelVersion';
+export * from './modelVersionId';
 export * from './pagination';
 export * from './patchPipelineNodeBody';
 export * from './patchPipelineNodeBodySettings';
@@ -691,6 +711,7 @@ export * from './rootNodeSettingsItemFilterFieldValuesItemSourcesItemOneOfTwo';
 export * from './rootNodeSettingsItemFilterFieldValuesItemValue';
 export * from './rootNodeSettingsStartedFieldProxies';
 export * from './rootNodeSettingsStartedFieldProxiesOutputItem';
+export * from './runCost';
 export * from './runId';
 export * from './runItem';
 export * from './runItemId';

package/openapi/gen/models/listBaseModels200.ts

@@ -0,0 +1,5 @@
+import type { BaseModel } from './baseModel';
+
+export type ListBaseModels200 = {
+  baseModels: BaseModel[];
+};

package/openapi/gen/models/listModelVersions200.ts

@@ -0,0 +1,7 @@
+import type { ModelVersion } from './modelVersion';
+import type { Pagination } from './pagination';
+
+export type ListModelVersions200 = {
+  versions: ModelVersion[];
+  pagination: Pagination;
+};

package/openapi/gen/models/listModelVersionsParams.ts

@@ -0,0 +1,5 @@
+
+export type ListModelVersionsParams = {
+limit?: number;
+offset?: number;
+};

package/openapi/gen/models/listProjectModels200.ts

@@ -0,0 +1,7 @@
+import type { Model } from './model';
+import type { Pagination } from './pagination';
+
+export type ListProjectModels200 = {
+  models: Model[];
+  pagination: Pagination;
+};

package/openapi/gen/models/listProjectModelsParams.ts

@@ -0,0 +1,5 @@
+
+export type ListProjectModelsParams = {
+limit?: number;
+offset?: number;
+};

package/openapi/gen/models/model.ts

@@ -0,0 +1,16 @@
+import type { ModelId } from './modelId';
+import type { ProjectId } from './projectId';
+import type { ModelDescription } from './modelDescription';
+import type { BaseModelId } from './baseModelId';
+import type { ModelArchivedAt } from './modelArchivedAt';
+
+export interface Model {
+  id: ModelId;
+  projectId: ProjectId;
+  name: string;
+  description: ModelDescription;
+  baseModelId: BaseModelId;
+  archivedAt: ModelArchivedAt;
+  createdAt: string;
+  updatedAt: string;
+}

package/openapi/gen/models/modelArchivedAt.ts

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

package/openapi/gen/models/modelDescription.ts

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

package/openapi/gen/models/modelId.ts

@@ -0,0 +1,2 @@
+
+export type ModelId = string;

package/openapi/gen/models/modelVersion.ts

@@ -0,0 +1,9 @@
+import type { ModelVersionId } from './modelVersionId';
+import type { ModelId } from './modelId';
+
+export interface ModelVersion {
+  id: ModelVersionId;
+  modelId: ModelId;
+  version: string;
+  createdAt: string;
+}

package/openapi/gen/models/modelVersionId.ts

@@ -0,0 +1,2 @@
+
+export type ModelVersionId = string;

package/openapi/gen/models/pipelineGraphSnapshotGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneone.ts

@@ -6,4 +6,5 @@ export type PipelineGraphSnapshotGraphNodesItemOneOfThreeoneSettingsAudienceAndP
   generationModelId?: PipelineGraphSnapshotGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneoneGenerationModelId;
   reasoningEffort?: PipelineGraphSnapshotGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneoneReasoningEffort;
   llmInstruction?: string;
+  maxCostPerAttempt: number;
 };

package/openapi/gen/models/runCost.ts

@@ -0,0 +1,7 @@
+import type { RunId } from './runId';
+
+export interface RunCost {
+  runId: RunId;
+  computedAt: string;
+  total: string;
+}

package/openapi/gen/models/validatePipelineGraphBodyGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneone.ts

@@ -6,4 +6,5 @@ export type ValidatePipelineGraphBodyGraphNodesItemOneOfThreeoneSettingsAudience
   generationModelId?: ValidatePipelineGraphBodyGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneoneGenerationModelId;
   reasoningEffort?: ValidatePipelineGraphBodyGraphNodesItemOneOfThreeoneSettingsAudienceAndPricingOneOfOneoneReasoningEffort;
   llmInstruction?: string;
+  maxCostPerAttempt: number;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toloka-platform/sdk",
-  "version": "0.1.0-preview.4",
+  "version": "0.1.0-preview.6",
   "private": false,
   "description": "Preview. Build, inspect, and operate Toloka pipeline projects as TypeScript source. The public API may change.",
   "license": "Apache-2.0",
@@ -32,6 +32,7 @@
     "build": "bun ./scripts/build-cli.ts ./dist/cli",
     "generate": "orval --config ./openapi/orval.config.js",
     "prepack": "bun run build",
+    "sync-skill-catalog": "bun ./scripts/sync-skill-catalog.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },

package/skills/catalog.json

@@ -0,0 +1,22 @@
+{
+  "skills": [
+    {
+      "id": "toloka-build",
+      "name": "Build Toloka pipelines as code",
+      "description": "Build, inspect, and change Toloka platform pipeline projects as TypeScript source with @toloka-platform/sdk and toloka. Use when the user wants to create, adopt, inspect, plan, or apply a pipeline project as code.",
+      "tags": ["pipelines", "authoring", "sdk"],
+      "version": "0.1.0-preview.6",
+      "digest": "d45d1124d27e19ee43c260ddf0c259ccdc343c5d641c2aeb538d6fedaeb99183",
+      "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.6",
+      "digest": "b71d06333786826edd51b909dfe8a20633870f235d03df4aae83d20c26e99205",
+      "files": ["SKILL.md", "references/report-template.md"]
+    }
+  ]
+}

package/skills/{SKILL.md → toloka-build/SKILL.md}

@@ -46,7 +46,7 @@ Import authoring helpers from `@toloka-platform/sdk`.
 
 Let constructors mint IDs for new declarations. Preserve `id` options generated by `toloka import`, but never invent or hand-edit raw `fp_…`, `ds.…`, `pl.…`, or `pp.…` values in authored settings. Never add a `layout` block: layout is not authored, existing layout is preserved, and the server supplies defaults.
 
-Read [node semantics](references/node-semantics.md) before selecting or configuring a node. Use the published [face image collection example](../examples/face-image-collection/) as a concrete authoring pattern.
+Read [node semantics](references/node-semantics.md) before selecting or configuring a node. Use `node_modules/@toloka-platform/sdk/examples/face-image-collection/` as a concrete authoring pattern.
 
 ## Get human-work settings right the first time
 
@@ -66,7 +66,7 @@ A successful `toloka validate` is necessary, not proof the pipeline can be launc
 
 ## Keep data and credentials out of source
 
-- Never put dataset items in pipeline source or `toloka.json`. After apply has created or resolved the dataset, upload JSONL objects with `toloka dataset upload <dataset> <file>`. If a later upload fails as schema-incompatible, run `toloka dataset fields <dataset>` and copy the printed `field()` declarations into source.
+- Never put dataset items in pipeline source or `toloka.json`. After apply has created or resolved the dataset, upload `.json`, `.jsonl`, or `.csv` rows with `toloka dataset upload <dataset> <file>`. If a later upload fails as schema-incompatible, run `toloka dataset fields <dataset>` and copy the printed `field()` declarations into source.
 - Put secret references in node settings, but never secret values. Set values through stdin with `toloka secret set <name>`, or use `toloka secret set <name> --from-env <variable>`.
 
 ## Credentials

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

@@ -33,9 +33,9 @@ bun add --dev @toloka-platform/sdk
 toloka init
 ```
 
-`init` does not require a selected project. It checks that `@toloka-platform/sdk` is declared in `dependencies` or `devDependencies`, then writes a Claude skill for `.claude/`, a Cursor rule when `.cursor/rules/` exists, and a marked block in an existing `AGENTS.md`; with no agent configuration, it creates the Claude skill and `AGENTS.md`. If a project is already selected through `--project-id`, `TOLOKA_PROJECT_ID` / `POTATO_PROJECT_ID`, `toloka.json`, or the machine registry, it also writes `toloka.json` when missing.
+`init` does not require a selected project. It checks that `@toloka-platform/sdk` is declared in `dependencies` or `devDependencies`, then maintains one `<toloka>` Agent Bootstrap block in `AGENTS.md` and writes minimal pointers to it: a Claude skill at `.claude/skills/toloka-bootstrap/SKILL.md` when `.claude/` exists (or when no agent configuration exists at all) and an always-applied Cursor rule at `.cursor/rules/toloka-bootstrap.mdc` when `.cursor/rules/` exists. If a project is already selected through `--project-id`, `TOLOKA_PROJECT_ID` / `POTATO_PROJECT_ID`, `toloka.json`, or the machine registry, it also writes `toloka.json` when missing.
 
-The generated entry points contain the core read, edit, validate, plan, and apply loop and point back to the fuller references in this package. Every `toloka` command except `init` compares the recorded skill-content digest with the installed SDK and warns on stderr when they differ. The warning never blocks the command; re-run `toloka init` to refresh the pointers.
+The bootstrap is small: it tells an agent to run `toloka --help`, search the bundled Skill Catalog with `toloka skill search <query>`, install the match with `toloka skill install <skill-id>`, and read `.agents/skills/<skill-id>/SKILL.md`. This skill is that installed copy. Commands warn on stderr when a generated legacy entry point is still present or the recorded bootstrap version differs from the installed SDK. Help, `init`, `report`, `project url`, and version invocations skip this checkout-dependent warning. The warning never blocks a command; re-run `toloka init` to refresh the bootstrap and its pointers.
 
 ## Store credentials once
 
@@ -71,13 +71,16 @@ require `toloka login` first because they read and write the credentials file. W
 project ID in this order: `--project-id`, `TOLOKA_PROJECT_ID`, `POTATO_PROJECT_ID`, `toloka.json`,
 then the machine registry `current`.
 
-Anonymous command telemetry is on by default (`sdk_cli_command_completed` / `sdk_cli_command_failed`). Set `TOLOKA_TELEMETRY=0` or `DO_NOT_TRACK=1` to disable it. CI is off unless `TOLOKA_TELEMETRY=1`.
+Anonymous command telemetry is on by default (`sdk_cli_command_completed` / `sdk_cli_command_failed`). `toloka report` uses the same PostHog client to send explicitly approved Markdown in `sdk_cli_issue_report_submitted`. Set `TOLOKA_TELEMETRY=0` or `DO_NOT_TRACK=1` to disable both; CI is off unless `TOLOKA_TELEMETRY=1`.
 
 All commands accept `--source-root <directory>`. Prefer running from the source root so paths and diffs stay obvious. `init` does not walk up: it binds the working directory or `--source-root` only.
 
 The real command surface is:
 
 ```text
+toloka version
+toloka -v
+toloka --version
 toloka login
 toloka logout
 toloka auth-status
@@ -85,6 +88,7 @@ toloka project list
 toloka project add [alias] [projectId]
 toloka project switch <alias>
 toloka project current
+toloka project url
 toloka project remove <alias>
 toloka project create [alias] [--name <name>] [--team-id <id>]
 toloka init
@@ -105,12 +109,29 @@ toloka pipeline runs [name] [--limit <n>]
 toloka pipeline cost [name] [--item-limit <n>]
 toloka pipeline results <runId> [--limit <n>] [--failed]
 toloka pipeline cancel <runId>
+toloka base-model list [--json]
+toloka base-model get <id> [--json]
+toloka model list [--json]
+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 skill list [--json]
+toloka skill search <query> [--json]
+toloka skill install <skill-id> [--force]
+toloka report <markdown> [--authored-by human|agent] [--confirm]
 ```
 
 Select the platform project with `toloka project add` or `toloka project create` before `import`, `plan`, or `apply`. `init` may run first, and `import` uses the selected project when the id is omitted.
 
+`toloka project url` prints only the selected project's platform UI URL. Use it when the user needs a working link to inspect the live project.
+
 `toloka pipeline cost [name] [--item-limit <n>]` forecasts what a run of a live pipeline would bill. It does not start a run and does not change the graph. Name the live pipeline or id; a TTY may pick among several. The typed client equivalent is `client.pipelines.estimateCost({ pipelineId, itemLimit? })`.
 
+## Manage model checkpoints
+
+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.
+
 ## Adopt an existing live project
 
 1. Run `toloka init` in the intended source root if the agent entry points are not installed yet.
@@ -176,7 +197,7 @@ Declare the fields in source, then upload rows:
 toloka dataset upload <dataset> <file>
 ```
 
-The input file is JSONL: each non-empty line must parse as one JSON object. The dataset does not have to exist yet: when a pipeline in source binds it, upload creates it and declares that pipeline's columns, so rows land in real columns rather than in the raw `uploaded` blob. Upload refuses when no pipeline in source declares a name because it would have no column names to map onto. An id-shaped argument is never created; upload fails when that dataset id does not exist in the project. Upload appends items; apply never uploads, replaces, or deletes rows. Duplicate live names must be addressed by id.
+The CLI infers the input format from its extension and uploads the original bytes without conversion: `.json` is an array of row objects, `.jsonl` has one object per non-empty line, and `.csv` uses its header row as field names with every value ingested as a string. JSONL is validated locally before upload. If transfer or finalization fails, the CLI cancels the started upload before returning the error, so another upload can start immediately and may reuse the same filename. The dataset does not have to exist yet: when a pipeline in source binds it, upload creates it and declares that pipeline's columns, so rows land in real columns rather than in the raw `uploaded` blob. Upload refuses when no pipeline in source declares a name because it would have no column names to map onto. An id-shaped argument is never created; upload fails when that dataset id does not exist in the project. Upload appends items; applying source never deletes them.
 
 If a later upload fails with a schema-incompatibility error, inspect the inferred schema from the first successful upload:
 
@@ -254,4 +275,4 @@ Read the returned path and reason. Check connection endpoints, duplicate or unkn
 
 ## Use the shipped example
 
-Read [the face image collection pipeline](../../examples/face-image-collection/pipeline.ts), its `fields.ts`, and its `nodes/` modules for a real composition of `field`, `root`, `generation`, `code`, `connect`, and `definePipeline`. Copy its source organization, not its task-specific settings.
+Read `node_modules/@toloka-platform/sdk/examples/face-image-collection/pipeline.ts`, its `fields.ts`, and its `nodes/` modules for a real composition of `field`, `root`, `generation`, `code`, `connect`, and `definePipeline`. Copy its source organization, not its task-specific settings.

package/skills/toloka-report-issue/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: toloka-report-issue
+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.
+---
+
+# Report a Toloka problem
+
+Use this skill when Toloka platform, CLI, or SDK behavior blocks the user's work and they want Toloka engineers to investigate. The result is one Markdown issue report sent through the `toloka` CLI. Nothing leaves the machine until the user has reviewed the complete report and approved it.
+
+## Workflow
+
+1. Collect verified facts: what the user ran, what they expected, what happened, and any relevant project, pipeline, dataset, run, thread, or request IDs. Ask for missing reproduction steps or reproduce the failure with real commands. Never invent a timeline, command output, or identifier.
+2. Copy [the template](references/report-template.md), preserve its section order, and replace the example with the user's evidence. Write `None` for sections that do not apply. The final UTF-8 Markdown file must not exceed 256 KiB.
+3. Redact before previewing. Include only evidence the user selected. Replace every API key, token, password, cookie, connection string, or personal value with a marker such as `[REDACTED:api-key]`, and list each replacement under Redactions without the original value. Never read environment variables, credential files, shell history, or logs the user did not name.
+4. Show the user the exact complete Markdown file and ask whether to send it. If they decline or request changes, do not submit; revise the file and ask again.
+5. Only after approval, run `toloka report <report.md> --authored-by agent --confirm`. The command previews the same Markdown, submits it as one PostHog event, flushes delivery, and prints `Submitted issue report: <id>` only after PostHog accepts the flush.
+6. Return the printed report ID to the user. If submission fails, keep the Markdown file, report the exact error, and do not claim success or retry without approval.
+
+## Boundaries
+
+- Submit only the Markdown file. The command has no attachment or structured-reference flags; put relevant IDs and text evidence in the report itself.
+- The event contains the complete Markdown, report ID, UTF-8 byte length, declared authorship, platform origin, and the standard pseudonymous CLI telemetry context. It never reads or sends the API key.
+- `--authored-by agent` records who prepared the report. It does not authenticate or grant access.
+- Issue reporting is unavailable when CLI telemetry is disabled. Do not bypass that setting.
+- Use the CLI, not the SDK or raw PostHog API. The user-visible preview and explicit approval are the consent boundary.

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

@@ -0,0 +1,34 @@
+# Issue Report: `toloka apply` returns HTTP 500 for the cat labeling project
+
+## Summary
+
+`toloka apply` fails with HTTP 500 after `toloka validate` passed, so the edited pipeline never reaches the platform.
+
+## Steps to reproduce
+
+1. Change the labeler instruction in `pipelines/cat-labeling/nodes/annotate-cats/node.ts`.
+2. Run `toloka validate`; it reports no issues.
+3. Run `toloka apply`.
+
+## Expected behavior
+
+`toloka apply` writes the new graph version and prints the changed node.
+
+## Actual behavior
+
+The CLI exits 1 with `Potato API request failed with status 500`. The same command failed three times between 09:12 and 09:20 UTC; `toloka plan` still shows the pending change.
+
+## Relevant IDs
+
+- Project: pp.0192f3a4-5b6c-7d8e-9f01-23456789abcd
+- Pipeline: pl.0192f3a4-5b6c-7d8e-9f01-23456789abce
+- Request: None supplied
+
+## Environment
+
+- toloka CLI 0.1.0-preview.6 (`toloka --version`), Bun 1.4.0, macOS 15
+- Platform: https://platform.toloka.ai
+
+## Redactions
+
+- The API key in the user-selected command output was replaced with `[REDACTED:api-key]`.

package/src/cli/analytics.ts

@@ -1,3 +1,4 @@
+import { assert } from "es-toolkit";
 import { randomUUID } from "node:crypto";
 import { chmod, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
@@ -28,13 +29,22 @@ export type CliAnalyticsCapture = {
   readonly error?: unknown;
 };
 
+export type IssueReportSubmission = {
+  readonly reportId: string;
+  readonly reportText: string;
+  readonly authoredBy: "human" | "agent";
+  readonly platform: string;
+};
+
 export type CliAnalytics = {
   readonly shouldIdentify: boolean;
+  readonly issueReportingEnabled: boolean;
   readonly identifyCurrentUser: (user: {
     readonly id: string;
     readonly email: string | null;
   }) => void;
   readonly captureCommand: (event: CliAnalyticsCapture) => void;
+  readonly submitIssueReport: (report: IssueReportSubmission) => Promise<void>;
   readonly shutdown: () => Promise<void>;
 };
 
@@ -46,6 +56,8 @@ export type PosthogLike = {
     disableGeoip: boolean;
   }) => void;
   alias: (event: { distinctId: string; alias: string }) => void;
+  flush: () => Promise<void>;
+  on?: (event: "error", listener: (error: Error) => void) => void;
   shutdown: (shutdownTimeoutMs?: number) => Promise<void>;
 };
 
@@ -86,6 +98,7 @@ const COMMAND_GROUPS: Readonly<Record<string, Readonly<Record<string, true>>>> =
   },
   dataset: { list: true, fields: true, load: true, upload: true },
   secret: { set: true },
+  skill: { list: true, search: true, install: true },
 };
 
 const ROOT_COMMANDS: Readonly<Record<string, true>> = {
@@ -99,6 +112,8 @@ const ROOT_COMMANDS: Readonly<Record<string, true>> = {
   plan: true,
   status: true,
   validate: true,
+  report: true,
+  version: true,
   whoami: true,
 };
 
@@ -116,6 +131,7 @@ const nameFromTokens = (tokens: readonly string[]): string => {
 };
 
 export function commandNameFromArgv(argv: readonly string[]): string {
+  if (argv.includes("-v") || argv.includes("--version")) return "version";
   const tokens: string[] = [];
   for (let index = 0; index < argv.length; index += 1) {
     const token = argv[index];
@@ -161,8 +177,12 @@ const readAnonymousId = async (environment: CliEnvironment): Promise<string> =>
 
 const noopAnalytics = (): CliAnalytics => ({
   shouldIdentify: false,
+  issueReportingEnabled: false,
   identifyCurrentUser() {},
   captureCommand() {},
+  async submitIssueReport() {
+    assert(false, "Issue reporting is disabled. Re-run with TOLOKA_TELEMETRY=1.");
+  },
   async shutdown() {},
 });
 
@@ -177,6 +197,11 @@ export function createCliAnalytics(options: {
   let client = options.client;
   let distinctId = options.distinctId;
   let identifiedUserId: string | undefined;
+  const deliveryErrors: Error[] = [];
+  const captureDeliveryError = (error: Error) => {
+    deliveryErrors.push(error);
+  };
+  client?.on?.("error", captureDeliveryError);
 
   const ensure = async () => {
     if (client !== undefined && distinctId !== undefined) return;
@@ -186,7 +211,7 @@ export function createCliAnalytics(options: {
         flushAt: 1,
         flushInterval: 0,
       });
-      created.on("error", () => {});
+      created.on("error", captureDeliveryError);
       client = created;
     }
     distinctId ??= await readAnonymousId(environment);
@@ -202,6 +227,7 @@ export function createCliAnalytics(options: {
   let queue: Promise<void> = ensure().catch(() => {});
 
   return {
+    issueReportingEnabled: true,
     shouldIdentify: true,
     identifyCurrentUser(user) {
       queue = queue
@@ -252,6 +278,32 @@ export function createCliAnalytics(options: {
         })
         .catch(() => {});
     },
+    submitIssueReport(report) {
+      const submission = queue.then(async () => {
+        assert(client && distinctId, "PostHog issue reporting could not be initialized.");
+        deliveryErrors.length = 0;
+        client.capture({
+          distinctId,
+          event: "sdk_cli_issue_report_submitted",
+          disableGeoip: true,
+          properties: {
+            ...sharedProperties(),
+            report_id: report.reportId,
+            report_text: report.reportText,
+            report_length_bytes: new TextEncoder().encode(report.reportText).length,
+            authored_by: report.authoredBy,
+            platform: report.platform,
+            $process_person_profile: false,
+          },
+        });
+        await client.flush();
+        const reportError = deliveryErrors[0];
+        deliveryErrors.length = 0;
+        if (reportError !== undefined) throw reportError;
+      });
+      queue = submission.catch(() => {});
+      return submission;
+    },
     async shutdown() {
       try {
         await queue;