@toloka-platform/sdk 0.2.0-preview.3 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +5 -6
  2. package/dist/cli/toloka.js +136 -136
  3. package/dist/cli/toloka.js.jsc +0 -0
  4. package/dist/cli/toloka.js.jsc.sha256 +1 -1
  5. package/dist/cli/toloka.js.sha256 +1 -1
  6. package/docs/cli-v2.md +3 -2
  7. package/docs/cli.md +35 -7
  8. package/docs/getting-started.md +4 -2
  9. package/docs/limitations.md +2 -2
  10. package/openapi/gen/models/baseModel.ts +1 -0
  11. package/openapi/gen/models/currentUser.ts +2 -0
  12. package/openapi/gen/models/currentUserTeamsItem.ts +6 -0
  13. package/openapi/gen/models/gistingTrainingConfiguration.ts +6 -2
  14. package/openapi/gen/models/gistingTrainingConfigurationBatchSize.ts +2 -0
  15. package/openapi/gen/models/gistingTrainingConfigurationGistTokens.ts +2 -0
  16. package/openapi/gen/models/gistingTrainingConfigurationInput.ts +6 -2
  17. package/openapi/gen/models/gistingTrainingConfigurationInputBatchSize.ts +2 -0
  18. package/openapi/gen/models/gistingTrainingConfigurationInputGistTokens.ts +2 -0
  19. package/openapi/gen/models/index.ts +9 -4
  20. package/openapi/gen/models/sftTrainingConfiguration.ts +6 -3
  21. package/openapi/gen/models/sftTrainingConfigurationBatchSize.ts +2 -0
  22. package/openapi/gen/models/sftTrainingConfigurationInput.ts +6 -3
  23. package/openapi/gen/models/sftTrainingConfigurationInputBatchSize.ts +2 -0
  24. package/openapi/gen/models/sftTrainingConfigurationInputLoraRank.ts +2 -0
  25. package/openapi/gen/models/sftTrainingConfigurationLoraRank.ts +2 -0
  26. package/package.json +2 -2
  27. package/skills/catalog.json +11 -11
  28. package/skills/toloka-build/SKILL.md +29 -18
  29. package/skills/toloka-build/references/node-semantics.md +7 -7
  30. package/skills/toloka-build/references/workflow-and-cli.md +15 -12
  31. package/skills/toloka-fine-tuning/SKILL.md +145 -62
  32. package/skills/toloka-get-started/SKILL.md +37 -21
  33. package/skills/toloka-gisting/SKILL.md +156 -66
  34. package/skills/toloka-report-issue/references/report-template.md +1 -1
  35. package/src/cli/analytics.ts +50 -23
  36. package/src/cli/auth.ts +31 -12
  37. package/src/cli/auto-update.ts +12 -6
  38. package/src/cli/check.ts +76 -29
  39. package/src/cli/cli-entry.ts +3 -2
  40. package/src/cli/cli-error.ts +43 -0
  41. package/src/cli/commands/dataset.ts +13 -3
  42. package/src/cli/commands/models.ts +6 -7
  43. package/src/cli/commands/pipeline.ts +6 -7
  44. package/src/cli/commands/project.ts +9 -16
  45. package/src/cli/commands/report.ts +6 -2
  46. package/src/cli/commands/secret.ts +5 -4
  47. package/src/cli/commands/source.ts +4 -4
  48. package/src/cli/commands/status.ts +2 -3
  49. package/src/cli/commands/training.ts +50 -17
  50. package/src/cli/config.ts +2 -2
  51. package/src/cli/context.ts +55 -17
  52. package/src/cli/credentials.ts +12 -4
  53. package/src/cli/data.ts +96 -34
  54. package/src/cli/delivery-orders.ts +18 -1
  55. package/src/cli/file-system.ts +6 -2
  56. package/src/cli/format-error.ts +45 -2
  57. package/src/cli/init.ts +13 -7
  58. package/src/cli/models.ts +43 -12
  59. package/src/cli/program.ts +5 -56
  60. package/src/cli/project-context.ts +117 -32
  61. package/src/cli/project.ts +80 -28
  62. package/src/cli/report.ts +24 -9
  63. package/src/cli/runs.ts +33 -8
  64. package/src/cli/settings.ts +13 -5
  65. package/src/cli/skill.ts +61 -22
  66. package/src/cli/source.ts +3 -2
  67. package/src/cli/terminal-io.ts +13 -6
  68. package/src/cli/trainings.ts +129 -35
  69. package/src/cli/version.ts +2 -2
  70. package/src/client.ts +3 -9
  71. package/src/transport.ts +13 -1
  72. package/openapi/gen/models/gistingTrainingConfigurationInputRegime.ts +0 -2
  73. package/openapi/gen/models/gistingTrainingConfigurationRegime.ts +0 -2
  74. package/openapi/gen/models/sftTrainingConfigurationInputRegime.ts +0 -2
  75. package/openapi/gen/models/sftTrainingConfigurationRegime.ts +0 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Build and operate Toloka pipeline projects as TypeScript source.
4
4
 
5
- > **Beta.** This SDK is not stable. The authoring API, the CLI surface, and the generated source layout can change without a major version bump. Pin an exact version. Do not depend on this in production yet. Read [limitations](./docs/limitations.md).
5
+ > **Stable 0.2.0.** The current supported release is published on `latest`. Because the SDK is still `0.x`, the authoring API, CLI surface, and generated source layout can change between minor releases. Use `latest` to stay current, or pin `@toloka-platform/sdk@0.2.0` for reproducible installs. Read [limitations](./docs/limitations.md).
6
6
 
7
7
  A pipeline project is a graph of nodes that moves items from a dataset through deterministic code and human work and back into the dataset. This package lets you write that project as TypeScript, keep it in version control, and reconcile it onto the platform with one command.
8
8
 
@@ -43,7 +43,7 @@ toloka init
43
43
 
44
44
  ## Install
45
45
 
46
- Install the bytecode-cached CLI and add the Beta SDK to the project:
46
+ Install the bytecode-cached CLI and add the stable SDK to the project:
47
47
 
48
48
  ```sh
49
49
  curl -fsSL https://platform.toloka.ai/cli/install.sh | sh
@@ -52,11 +52,10 @@ bun add @toloka-platform/sdk@latest
52
52
 
53
53
  The installer requires Bun 1.4.0 or newer, installs `@toloka-platform/sdk` globally, and exposes `toloka` through Bun's global binary directory. The project install makes SDK imports resolvable.
54
54
 
55
- Two channels are published. `latest` is the stable channel. `preview` is the Beta channel that adds Training (`toloka training`), the agent runbooks, and their bundled skills. Install one channel for both the CLI and the SDK:
55
+ `latest` currently resolves to stable `0.2.0`. It includes Training (`toloka training`), the agent runbooks, and their bundled skills. For a reproducible project install, pin the current stable version:
56
56
 
57
57
  ```sh
58
- curl -fsSL https://platform.toloka.ai/cli/install.sh | TOLOKA_CLI_CHANNEL=preview sh
59
- bun add @toloka-platform/sdk@preview
58
+ bun add @toloka-platform/sdk@0.2.0
60
59
  ```
61
60
 
62
61
  For a guided first run, start a fresh coding-agent session and ask it to follow the [Toloka agent bootstrap](https://platform.toloka.ai/agents/SKILL.md). It routes to the data-labeling, fine-tuning, or gisting runbook and the matching packaged skill.
@@ -72,7 +71,7 @@ For a guided first run, start a fresh coding-agent session and ask it to follow
72
71
  | [Datasets](./docs/datasets.md) | columns, immutable schemas, loading rows, what plan refuses |
73
72
  | [CLI](./docs/cli.md) | every command, flag, exit code, and the reconcile loop |
74
73
  | [Troubleshooting](./docs/troubleshooting.md) | the failures you will actually hit, and what to do about each |
75
- | [Limitations](./docs/limitations.md) | Beta status and what this SDK does not do yet |
74
+ | [Limitations](./docs/limitations.md) | current constraints and `0.x` compatibility expectations |
76
75
 
77
76
  ## Examples
78
77