@toloka-platform/sdk 0.10.1 → 0.11.1

package/dist/cli/toloka.js.jsc.sha256

@@ -1 +1 @@
-859c02ad3a3eb8c625626fa848dc18f99d9a26182acf6711d7494aab99c97d58  toloka.js.jsc
+6a0f8dbdd98f49a9c663bb3051960c4f168961bc4ebd8b428ae75fd5f07ba994  toloka.js.jsc

package/dist/cli/toloka.js.sha256

@@ -1 +1 @@
-282112f0046d172447dc497f576ae5d0a8a026e7273e66614df358793fd41245  toloka.js
+20b4b75534617c8aed19bf129f8b78fe18d43a5a91221f1aa4bf2fbc0f792175  toloka.js

package/openapi/gen/models/pipelineCostEstimateNodesItemOneOfFive.ts

@@ -13,4 +13,5 @@ export type PipelineCostEstimateNodesItemOneOfFive = {
   maxTotal: string;
   perItemExpected: PipelineCostEstimateNodesItemOneOfFivePerItemExpected;
   displayBreakdown: unknown[];
+  warning?: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toloka-platform/sdk",
-  "version": "0.10.1",
+  "version": "0.11.1",
   "private": false,
   "description": "Build, inspect, and operate Toloka pipeline projects as TypeScript source. The public API may change between minor versions before 1.0.",
   "license": "Apache-2.0",
@@ -77,6 +77,6 @@
     "bun": ">=1.4.0"
   },
   "tolokaBuild": {
-    "commit": "e43b0e3d09a4dd7223638ac15b16fa7ce2f0c28d"
+    "commit": "62d9c4558758f7409b65de7c849c8a2e8d15ba9a"
   }
 }

package/skills/catalog.json

@@ -11,8 +11,8 @@
         "testing",
         "checks"
       ],
-      "version": "0.10.1",
-      "digest": "a52f9d3be18876289f03f81aaa18c31904b3b4cb98cd0fd3b26d6177834f24c9",
+      "version": "0.11.1",
+      "digest": "79283e8ca89ddafa3d6206be108db32046f6941fb52d4b622aec72c20b791de7",
       "files": [
         "SKILL.md",
         "references/node-semantics.md",
@@ -29,7 +29,7 @@
         "bug",
         "report"
       ],
-      "version": "0.10.1",
+      "version": "0.11.1",
       "digest": "70f0bd2c80b32f87896aeb27c363b8a2d37f40e22424f57fe1aad142e125ad67",
       "files": [
         "SKILL.md",
@@ -46,7 +46,7 @@
         "getting-started",
         "agent"
       ],
-      "version": "0.10.1",
+      "version": "0.11.1",
       "digest": "ccf148c682de4e452bb031db95d3933257899006b1766f0fdbc3d15265a63bb9",
       "files": [
         "SKILL.md"
@@ -63,7 +63,7 @@
         "sft",
         "models"
       ],
-      "version": "0.10.1",
+      "version": "0.11.1",
       "digest": "279c69977eef170dada20b664ee0c30858681e84a2cabb2fdff18b8bb1bdc055",
       "files": [
         "SKILL.md"
@@ -80,7 +80,7 @@
         "prompt",
         "models"
       ],
-      "version": "0.10.1",
+      "version": "0.11.1",
       "digest": "b9f314eb6b39754bc8d2ae79aca3dc680fced5f14948c975d1e084a83c2e0a8c",
       "files": [
         "SKILL.md"

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

@@ -101,7 +101,9 @@ A scoped token downloads project files in two steps: a request to `ProjectFile.u
 ## Configure the CLI
 
 Provide the API key and base URL on networked workflows through `TOLOKA_API_KEY` and
-`TOLOKA_BASE_URL`, or with `--api-key` and `--base-url`. The registry-mutating commands
+`TOLOKA_BASE_URL`, or with `--api-key` and `--base-url`. A base URL with a path (a gateway such as
+`https://gateway.example/ss/pp.1`) keeps that path on every request, with or without a trailing
+slash; use the given URL unchanged. The registry-mutating commands
 `toloka project add`, `toloka project switch`, `toloka project remove`, and `toloka project create`
 require `toloka login` first because they read and write the credentials file. When flags or
 `TOLOKA_*` variables are also present, they must identify the same stored key and platform. Resolve
@@ -191,7 +193,7 @@ Resolve the intended platform project before `import`, `plan`, or `apply`; use a
 
 `toloka audience specialization list` prints the global specialization catalog: `ID`, `NAME`, and `EXPERTS` columns sorted by name (`--json` for the array). Run it before setting `audience.specializations` on a node, pick entries by name, and copy `ID` into `qualificationId` and `NAME` into `value`; never invent a `qualificationId`. `EXPERTS` counts ID-verified experts currently eligible for tasks; a `0` means the id is valid but nobody currently qualifies, so prefer another specialization or widen the audience.
 
-`toloka pipeline cost [name] [--item-limit <n>]` forecasts what a run of a live, validated pipeline would bill. It does not start a run or change the graph. If any billed node is marked `skipped`, the displayed total is incomplete and must not be presented as the pipeline price. Compute and label a labor floor for each skipped billed node as `items × pricePerTask × annotations per item`, using `1` for generation and `overlap` for quorum. Also report `maxEntities`, quality-criteria count, and only exclusions applicable to the authored QA and workflow. Apply accepting a rate does not prove its final billed value.
+`toloka pipeline cost [name] [--item-limit <n>]` forecasts what a run of a live, validated pipeline would bill. It does not start a run or change the graph. If any billed node is marked `skipped`, the displayed total is incomplete and must not be presented as the pipeline price. Compute and label a labor floor for each skipped billed node as `items × pricePerTask × annotations per item`, using `1` for generation and `overlap` for quorum. Also report `maxEntities`, quality-criteria count, and only exclusions applicable to the authored QA and workflow. Apply accepting a rate does not prove its final billed value. If the output lists warnings, include them when you present the forecast.
 
 ## Manage model checkpoints
 

package/src/cli/cost.ts

@@ -56,9 +56,10 @@ const collectLineRows = (line: CostLine, depth: number): TableRow[] => {
 
 const collectNodeRows = (
   nodes: PipelineCostEstimate["nodes"],
-): { billed: TableRow[]; unpriced: string[] } => {
+): { billed: TableRow[]; unpriced: string[]; warnings: string[] } => {
   const billed: TableRow[] = [];
   const unpriced: string[] = [];
+  const warnings: string[] = [];
 
   for (const node of nodes) {
     if (node.kind === "priced") {
@@ -66,6 +67,7 @@ const collectNodeRows = (
       for (const line of node.displayBreakdown) {
         if (isCostLine(line)) billed.push(...collectLineRows(line, 1));
       }
+      if (node.warning !== undefined) warnings.push(`  ${node.nodeNameDisplay}: ${node.warning}`);
       continue;
     }
 
@@ -76,7 +78,7 @@ const collectNodeRows = (
     );
   }
 
-  return { billed, unpriced };
+  return { billed, unpriced, warnings };
 };
 
 const collectTotalRows = (total: PipelineCostEstimate["total"]): TableRow[] => {
@@ -100,7 +102,7 @@ export const formatCostEstimate = (
   estimate: PipelineCostEstimate,
   pipelineName: string,
 ): string => {
-  const { billed, unpriced } = collectNodeRows(estimate.nodes);
+  const { billed, unpriced, warnings } = collectNodeRows(estimate.nodes);
   const totals = collectTotalRows(estimate.total);
   const table = formatTable([["Item", "Expected", "Maximum"], ...billed, ...totals]);
   const billedRows = table.slice(0, 1 + billed.length);
@@ -122,6 +124,10 @@ export const formatCostEstimate = (
     output.push("", "Not billed", ...unpriced);
   }
 
+  if (warnings.length > 0) {
+    output.push("", "Warnings", ...warnings);
+  }
+
   if (estimate.isInternalPricing === true) {
     output.push("", "Internal-team pricing.");
   }

package/src/transport.ts

@@ -47,6 +47,15 @@ const prepareRequestInit = (requestOptions: RequestInit, headers: Headers): Requ
   return { ...requestOptions, headers, body: "{}" };
 };
 
+// The generated client passes absolute paths (`/api/v2-beta/...`), and `new URL(path, base)` resolves
+// those against the base's origin, dropping its path. Join them instead, so a base URL served under a
+// path prefix (a gateway in front of the platform) keeps that prefix.
+const resolveRequestUrl = (url: string, baseUrl: string): URL => {
+  if (!url.startsWith("/") || url.startsWith("//")) return new URL(url, baseUrl);
+  const base = new URL(baseUrl);
+  return new URL(`${base.pathname.replace(/\/+$/, "")}${url}`, base.origin);
+};
+
 export function potatoFetch<T>(url: string, options: TransportRequestInit): Promise<T>;
 export async function potatoFetch(url: string, options: TransportRequestInit): Promise<unknown> {
   const { fetch: fetchImplementation = globalThis.fetch, authorization, ...requestOptions } = options;
@@ -57,7 +66,7 @@ export async function potatoFetch(url: string, options: TransportRequestInit): P
   if (authorization !== undefined) headers.set("Authorization", await authorization());
 
   const response = await fetchImplementation(
-    new URL(url, baseUrl),
+    resolveRequestUrl(url, baseUrl),
     prepareRequestInit(requestOptions, headers),
   );
   const text = await response.text();