@toloka-platform/sdk 0.2.0 → 0.2.1

package/src/cli/check.ts

@@ -23,7 +23,8 @@ import {
   type TestEvidence,
   type TestEvidenceKind,
 } from "../testing/test-evidence";
-import { resolveCliEntry } from "./cli-entry";
+import { cliRelaunchCommand } from "./cli-entry";
+import { bunSubprocessEnvironment } from "./native-runtime";
 import { API_KEY_ENVIRONMENT_NAMES } from "./environment";
 import { loadProjectSource, type ProjectSource } from "./source";
 import { assertCli, REPORT_HINT, TolokaCliError } from "./cli-error";
@@ -160,16 +161,15 @@ export const collectOutput = async (stream: NodeJS.ReadableStream): Promise<stri
   return truncated ? `${output}\n…output truncated` : output;
 };
 
-const runModule = async (
+const runCommand = async (
   sourceRoot: string,
-  modulePath: string,
+  executable: string,
   args: readonly string[],
-  environment: NodeJS.ProcessEnv = process.env,
+  environment: NodeJS.ProcessEnv,
   signal?: AbortSignal,
-  executable: string = process.execPath,
 ): Promise<ToolRunResult> => {
   signal?.throwIfAborted();
-  const child = spawn(executable, [modulePath, ...args], {
+  const child = spawn(executable, args, {
     cwd: sourceRoot,
     env: environment,
     stdio: ["ignore", "pipe", "pipe"],
@@ -208,11 +208,11 @@ const runTypeScript = async (
   signal?: AbortSignal,
 ): Promise<ToolRunResult> => {
   try {
-    return await runModule(
+    return await runCommand(
       sourceRoot,
-      resolveProjectModule(sourceRoot, "typescript", "bin/tsc"),
-      ["--noEmit"],
-      environment,
+      process.execPath,
+      [resolveProjectModule(sourceRoot, "typescript", "bin/tsc"), "--noEmit"],
+      bunSubprocessEnvironment(environment),
       signal,
     );
   } catch (error) {
@@ -247,11 +247,15 @@ const runVitest = async ({
         ? typedTestNamePattern(fingerprint, environment[TEST_NODE_FILTER_ENV])
         : undefined;
     return classifyVitestRun(
-      await runModule(
+      await runCommand(
         sourceRoot,
-        resolveProjectModule(sourceRoot, "vitest", "vitest.mjs"),
-        ["run", ...(focusedPattern === undefined ? [] : ["--testNamePattern", focusedPattern])],
-        environment,
+        process.execPath,
+        [
+          resolveProjectModule(sourceRoot, "vitest", "vitest.mjs"),
+          "run",
+          ...(focusedPattern === undefined ? [] : ["--testNamePattern", focusedPattern]),
+        ],
+        bunSubprocessEnvironment(environment),
         signal,
       ),
     );
@@ -804,11 +808,9 @@ const parseFreshCheckDiagnostic = (value: unknown): CheckDiagnostic => {
   const line = Reflect.get(value, "line");
   const column = Reflect.get(value, "column");
   const code = Reflect.get(value, "code");
-  assertCli(
-    typeof message === "string",
-    "Fresh check diagnostic has no message",
-    { hint: REPORT_HINT },
-  );
+  assertCli(typeof message === "string", "Fresh check diagnostic has no message", {
+    hint: REPORT_HINT,
+  });
   assertCli(
     severity === undefined || severity === "error" || severity === "warning",
     "Fresh check diagnostic has invalid severity",
@@ -845,11 +847,9 @@ const parseFreshCheckDiagnostic = (value: unknown): CheckDiagnostic => {
 };
 
 const parseFreshCheckResultItem = (value: unknown): CheckResult => {
-  assertCli(
-    typeof value === "object" && value !== null,
-    "Fresh check returned an invalid result",
-    { hint: REPORT_HINT },
-  );
+  assertCli(typeof value === "object" && value !== null, "Fresh check returned an invalid result", {
+    hint: REPORT_HINT,
+  });
   const scope = Reflect.get(value, "scope");
   const kind = Reflect.get(value, "kind");
   const status = Reflect.get(value, "status");
@@ -861,11 +861,9 @@ const parseFreshCheckResultItem = (value: unknown): CheckResult => {
   assertCli(isCheckScope(scope), "Fresh check returned an invalid scope", { hint: REPORT_HINT });
   assertCli(isCheckKind(kind), "Fresh check returned an invalid kind", { hint: REPORT_HINT });
   assertCli(isCheckStatus(status), "Fresh check returned an invalid status", { hint: REPORT_HINT });
-  assertCli(
-    Array.isArray(diagnostics),
-    "Fresh check returned invalid diagnostics",
-    { hint: REPORT_HINT },
-  );
+  assertCli(Array.isArray(diagnostics), "Fresh check returned invalid diagnostics", {
+    hint: REPORT_HINT,
+  });
   assertCli(
     sourceDirectory === undefined || typeof sourceDirectory === "string",
     "Fresh check returned an invalid source directory",
@@ -899,11 +897,9 @@ const parseFreshCheckResultItem = (value: unknown): CheckResult => {
 };
 
 const parseFreshCheckResult = (value: unknown, json: boolean): CheckProjectResult => {
-  assertCli(
-    typeof value === "object" && value !== null,
-    "Fresh check returned invalid JSON",
-    { hint: REPORT_HINT },
-  );
+  assertCli(typeof value === "object" && value !== null, "Fresh check returned invalid JSON", {
+    hint: REPORT_HINT,
+  });
   const exitCode = Reflect.get(value, "exitCode");
   const rawResults = Reflect.get(value, "results");
   assertCli(
@@ -973,30 +969,33 @@ export const readFreshCheckResult = async (
   }
 };
 export const runFreshCheck = async (options: CheckProjectOptions): Promise<CheckProjectResult> => {
-  const entry = resolveCliEntry();
   const resultDirectory = await mkdtemp(join(tmpdir(), "toloka-check-watch-result-"));
   const resultPath = join(resultDirectory, "result.json");
+  const environment = {
+    ...(process.env.PATH === undefined ? {} : { PATH: process.env.PATH }),
+    ...(options.environment ?? process.env),
+    [CHECK_RESULT_FILE_ENV]: resultPath,
+  };
+  const command = cliRelaunchCommand(
+    [
+      "--source-root",
+      options.sourceRoot,
+      "check",
+      ...(options.pipeline === undefined ? [] : [options.pipeline]),
+      ...(options.node === undefined ? [] : ["--node", options.node]),
+      "--json",
+    ],
+    environment,
+  );
   try {
     let run: ToolRunResult;
     try {
-      run = await runModule(
+      run = await runCommand(
         options.sourceRoot,
-        entry,
-        [
-          "--source-root",
-          options.sourceRoot,
-          "check",
-          ...(options.pipeline === undefined ? [] : [options.pipeline]),
-          ...(options.node === undefined ? [] : ["--node", options.node]),
-          "--json",
-        ],
-        {
-          ...(process.env.PATH === undefined ? {} : { PATH: process.env.PATH }),
-          ...(options.environment ?? process.env),
-          [CHECK_RESULT_FILE_ENV]: resultPath,
-        },
+        command.executable,
+        command.args,
+        command.environment,
         options.signal,
-        "bun",
       );
     } catch (error) {
       throw new FreshCheckProcessError(
@@ -1004,7 +1003,7 @@ export const runFreshCheck = async (options: CheckProjectOptions): Promise<Check
         `Unable to start the local check process: ${error instanceof Error ? error.message : String(error)}`,
         {
           cause: error,
-          hint: { description: "Check that bun is installed and on PATH, then re-run toloka check." },
+          hint: { description: "Reinstall the Toloka CLI, then re-run toloka check." },
         },
       );
     }

package/src/cli/cli-entry.ts

@@ -1,8 +1,20 @@
 import { existsSync, realpathSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { assertCli } from "./cli-error";
+import { isNativeCli } from "./native-runtime";
 
 const CLI_ENTRY = join("bin", "toloka.js");
+export type CliRelaunchCommand = {
+  readonly executable: string;
+  readonly args: readonly string[];
+  readonly environment: NodeJS.ProcessEnv;
+};
+
+export type CliRelaunchOptions = {
+  readonly native?: boolean;
+  readonly executable?: string;
+  readonly runtimeEntry?: string;
+};
 
 const runtimePath = (entry: string): string => {
   try {
@@ -40,3 +52,22 @@ export const resolveCliEntry = (runtimeEntry: string | undefined = process.argv[
   );
   return workingDirectoryEntry;
 };
+
+export const cliRelaunchCommand = (
+  argv: readonly string[],
+  environment: NodeJS.ProcessEnv,
+  options: CliRelaunchOptions = {},
+): CliRelaunchCommand => {
+  const executable = options.executable ?? process.execPath;
+  if (!(options.native ?? isNativeCli())) {
+    return {
+      executable:
+        options.executable ?? (Reflect.get(process.versions, "bun") ? process.execPath : "bun"),
+      args: [resolveCliEntry(options.runtimeEntry), ...argv],
+      environment,
+    };
+  }
+  const reexecEnvironment = { ...environment };
+  delete reexecEnvironment.BUN_BE_BUN;
+  return { executable, args: [...argv], environment: reexecEnvironment };
+};

package/src/cli/commands/audience.ts

@@ -0,0 +1,22 @@
+import type { Command } from "commander";
+import { listSpecializations } from "../audience";
+import { resolveContext, type CommandHost } from "../context";
+
+export const registerAudienceCommands = (program: Command, host: CommandHost): void => {
+  const { context, globals } = host;
+
+  const audience = program
+    .command("audience")
+    .description("inspect the expert audience catalog used by node audience filters");
+  const specialization = audience
+    .command("specialization")
+    .description("expert specializations (platform qualifications)");
+  specialization
+    .command("list")
+    .option("--json", "print JSON", false)
+    .description("list specializations with their id, name, and expert count")
+    .action(async (options: { json: boolean }) => {
+      const { client } = await resolveContext(globals(), context);
+      await listSpecializations(client, { json: options.json }, context.io);
+    });
+};

package/src/cli/commands/training.ts

@@ -64,7 +64,11 @@ export const registerTrainingCommands = (program: Command, host: CommandHost): v
     .option("--train-filter <field=value>", "training Dataset field equality filter")
     .option("--validation-filter <field=value>", "validation Dataset field equality filter")
     .option("--lora-rank <rank>", "SFT LoRA adapter rank: 8, 16, or 32 (default 16)", trainingLoraRank)
-    .option("--gist-tokens <count>", "gisting soft tokens: 8, 32, or 64 (default 32)", trainingGistTokens)
+    .option(
+      "--gist-tokens <count>",
+      'gisting soft tokens: 8, 32, or 64, or a fraction of the prompt "1/4", "1/8", "1/16", "1/32" (default 32)',
+      trainingGistTokens,
+    )
     .option("--epochs <count>", "training epochs, 1 through 5 (default 3)", trainingEpochs)
     .option(
       "--learning-rate <rate>",
@@ -111,7 +115,11 @@ export const registerTrainingCommands = (program: Command, host: CommandHost): v
       "replacement validation Dataset field equality filter",
     )
     .option("--lora-rank <rank>", "SFT LoRA adapter rank: 8, 16, or 32 (default 16)", trainingLoraRank)
-    .option("--gist-tokens <count>", "gisting soft tokens: 8, 32, or 64 (default 32)", trainingGistTokens)
+    .option(
+      "--gist-tokens <count>",
+      'gisting soft tokens: 8, 32, or 64, or a fraction of the prompt "1/4", "1/8", "1/16", "1/32" (default 32)',
+      trainingGistTokens,
+    )
     .option("--epochs <count>", "training epochs, 1 through 5 (default 3)", trainingEpochs)
     .option(
       "--learning-rate <rate>",

package/src/cli/context.ts

@@ -96,10 +96,15 @@ export const trainingLoraRank = (raw: string): 8 | 16 | 32 => {
   return value;
 };
 
-export const trainingGistTokens = (raw: string): 8 | 32 | 64 => {
+export const trainingGistTokens = (raw: string): 8 | 32 | 64 | "1/4" | "1/8" | "1/16" | "1/32" => {
+  if (raw === "1/4" || raw === "1/8" || raw === "1/16" || raw === "1/32") {
+    return raw;
+  }
   const value = Number(raw);
   if (value !== 8 && value !== 32 && value !== 64) {
-    throw new InvalidArgumentError("Expected 8, 32, or 64 gist tokens.");
+    throw new InvalidArgumentError(
+      'Expected 8, 32, or 64 gist tokens, or a fraction of the prompt: "1/4", "1/8", "1/16", or "1/32".',
+    );
   }
   return value;
 };

package/src/cli/init.ts

@@ -223,7 +223,12 @@ const bindCheckout = async (
   assertCli(
     existing === undefined || existing.projectId === projectId,
     `This directory is already bound to ${existing?.projectId}.`,
-    { hint: { description: "Run toloka init without --project-id to keep the current binding, or remove toloka.json to bind another project." } },
+    {
+      hint: {
+        description:
+          "Run toloka init without --project-id to keep the current binding, or remove toloka.json to bind another project.",
+      },
+    },
   );
   if (existing !== undefined) return undefined;
   await writeTolokaState(targetRoot, { projectId, pipelines: {}, datasets: {} });
@@ -275,7 +280,7 @@ export async function initProject(
   ];
   const warning = dependencyReady
     ? undefined
-    : `Warning: ${SDK_PACKAGE_NAME} is not listed in dependencies or devDependencies in ${join(targetRoot, "package.json")}. Run \`bun add --dev ${SDK_PACKAGE_NAME}\` before using \`toloka\`, then re-run \`toloka init\`.`;
+    : `Warning: ${SDK_PACKAGE_NAME} is not listed in dependencies or devDependencies in ${join(targetRoot, "package.json")}. Install it with npm or Bun before authoring pipelines, then re-run \`toloka init\`. Training commands do not require it.`;
   return {
     targetDirectory: targetRoot,
     files,

package/src/cli/models.ts

@@ -8,10 +8,9 @@ import { pipeline } from "node:stream/promises";
 
 import type { BaseModel, BaseModelId, Model, ModelVersion, PotatoClient } from "../client";
 import { assertCli, REPORT_HINT, RETRY_OR_REPORT_HINT } from "./cli-error";
+import { formatTable, type TableIo as ModelIo, writeOutput } from "./table";
 
 type ModelApi = Pick<PotatoClient, "baseModels" | "models">;
-type ModelIo = { readonly stdout: (text: string) => void };
-type TableRow = readonly string[];
 
 const BASE_MODEL_IDS = [
   "qwen3-4b",
@@ -20,25 +19,6 @@ const BASE_MODEL_IDS = [
   "qwen3-235b",
 ] satisfies readonly BaseModelId[];
 
-const formatTable = (rows: readonly TableRow[]): string => {
-  const widths = rows.reduce<number[]>(
-    (current, row) => row.map((cell, index) => Math.max(current[index] ?? 0, cell.length)),
-    [],
-  );
-  return rows
-    .map((row) =>
-      row
-        .map((cell, index) => cell.padEnd(widths[index] ?? cell.length))
-        .join("  ")
-        .trimEnd(),
-    )
-    .join("\n");
-};
-
-const writeOutput = (io: ModelIo, json: boolean, value: unknown, formatted: string): void => {
-  io.stdout(json ? JSON.stringify(value, null, 2) : formatted);
-};
-
 const formatBaseModel = (model: BaseModel): string =>
   formatTable([
     ["ID", model.id],

package/src/cli/native-runtime.ts

@@ -0,0 +1,7 @@
+export const isNativeCli = (): boolean =>
+  Reflect.get(globalThis, "Bun")?.isStandaloneExecutable === true;
+
+export const bunSubprocessEnvironment = (
+  environment: NodeJS.ProcessEnv,
+  native = isNativeCli(),
+): NodeJS.ProcessEnv => (native ? { ...environment, BUN_BE_BUN: "1" } : environment);

package/src/cli/program.ts

@@ -5,6 +5,7 @@ import type { CliAnalytics, CliAnalyticsCommandOutcome } from "./analytics";
 import type { AutoUpdateHooks } from "./auto-update";
 import { maybeAutoUpdate } from "./auto-update";
 import { CHECK_RESULT_FILE_ENV, type checkProject } from "./check";
+import { registerAudienceCommands } from "./commands/audience";
 import { registerAuthCommands } from "./commands/auth";
 import { registerConfigCommands } from "./commands/config";
 import { registerDatasetCommands } from "./commands/dataset";
@@ -91,6 +92,7 @@ export function createProgram(context: ProgramContext): CreatedProgram {
   registerAuthCommands(program, host);
   registerProjectCommands(program, host);
   registerDeliveryOrderCommands(program, host);
+  registerAudienceCommands(program, host);
   registerSourceCommands(program, host);
   registerSecretCommands(program, host);
   registerModelCommands(program, host);

package/src/cli/skill.ts

@@ -1,9 +1,19 @@
 import { createHash } from "node:crypto";
-import { copyFile, mkdir, mkdtemp, readFile, realpath, rename, rm, stat } from "node:fs/promises";
+import {
+  copyFile,
+  mkdir,
+  mkdtemp,
+  readFile,
+  realpath,
+  rename,
+  rm,
+  stat,
+  writeFile,
+} from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { assertSafeDestination, entryStats, hasErrorCode } from "./file-system";
 import { formatCliError } from "./format-error";
-import { releaseChannelFor, SDK_PACKAGE_NAME, SDK_VERSION } from "./sdk-version";
+import { SDK_PACKAGE_NAME, SDK_VERSION } from "./sdk-version";
 import { assertCli, REINSTALL_HINT, TolokaCliError } from "./cli-error";
 
 export const SKILL_CATALOG_MANIFEST = "catalog.json";
@@ -16,9 +26,7 @@ const MAX_MANIFEST_BYTES = 1024 * 1024;
 const MAX_SKILL_ID_LENGTH = 64;
 const SKILL_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 const DIGEST_PATTERN = /^[a-f0-9]{64}$/u;
-const UPGRADE_HINT = `bun add --global ${SDK_PACKAGE_NAME}@${
-  releaseChannelFor(SDK_VERSION) ?? "latest"
-}`;
+const UPGRADE_HINT = "rerun the CLI installer to update";
 
 export type SkillDescriptor = {
   readonly id: string;
@@ -86,21 +94,15 @@ const parseDescriptor = (value: unknown, invalid: (detail: string) => string): S
     { hint: REINSTALL_HINT },
   );
   assertCli(isNonEmptyString(name), invalid(`skill ${id} needs a name.`), { hint: REINSTALL_HINT });
-  assertCli(
-    isNonEmptyString(description),
-    invalid(`skill ${id} needs a description.`),
-    { hint: REINSTALL_HINT },
-  );
-  assertCli(
-    isStringArray(tags),
-    invalid(`skill ${id} tags must be strings.`),
-    { hint: REINSTALL_HINT },
-  );
-  assertCli(
-    isNonEmptyString(version),
-    invalid(`skill ${id} needs a version.`),
-    { hint: REINSTALL_HINT },
-  );
+  assertCli(isNonEmptyString(description), invalid(`skill ${id} needs a description.`), {
+    hint: REINSTALL_HINT,
+  });
+  assertCli(isStringArray(tags), invalid(`skill ${id} tags must be strings.`), {
+    hint: REINSTALL_HINT,
+  });
+  assertCli(isNonEmptyString(version), invalid(`skill ${id} needs a version.`), {
+    hint: REINSTALL_HINT,
+  });
   assertCli(
     typeof digest === "string" && DIGEST_PATTERN.test(digest),
     invalid(`skill ${id} digest must be the sha256 hex digest of its files.`),
@@ -154,6 +156,9 @@ const findSkillCatalogRootAbove = async (directory: string): Promise<string | un
 export async function resolveBundledSkillCatalogRoot(
   runtimeEntry: string | undefined = process.argv[1],
 ): Promise<string> {
+  if (Reflect.get(globalThis, "Bun")?.isStandaloneExecutable === true) {
+    return join(dirname(process.argv[1]!), "skills");
+  }
   const entry = runtimeEntry === undefined ? undefined : await realpath(runtimeEntry);
   const runtimeRoot =
     entry === undefined ? undefined : await findSkillCatalogRootAbove(dirname(entry));
@@ -197,11 +202,9 @@ export async function loadSkillCatalog(catalogRoot: string): Promise<SkillCatalo
   const skills = manifest.skills.map((skill) => parseDescriptor(skill, invalid));
   const ids = new Set<string>();
   for (const skill of skills) {
-    assertCli(
-      !ids.has(skill.id),
-      invalid(`skill id ${skill.id} appears more than once.`),
-      { hint: REINSTALL_HINT },
-    );
+    assertCli(!ids.has(skill.id), invalid(`skill id ${skill.id} appears more than once.`), {
+      hint: REINSTALL_HINT,
+    });
     ids.add(skill.id);
   }
   return { root: catalogRoot, manifestPath, skills };
@@ -329,7 +332,12 @@ export async function installSkill({
     for (const path of skill.files) {
       const target = join(temporary, path);
       await mkdir(dirname(target), { recursive: true });
-      await copyFile(join(catalog.root, skill.id, path), target);
+      const source = join(catalog.root, skill.id, path);
+      if (Reflect.get(globalThis, "Bun")?.isStandaloneExecutable === true) {
+        await writeFile(target, await readFile(source));
+      } else {
+        await copyFile(source, target);
+      }
     }
     assertCli(
       (await computeSkillDigest(temporary, skill.files)) === skill.digest,

package/src/cli/table.ts

@@ -0,0 +1,21 @@
+export type TableRow = readonly string[];
+export type TableIo = { readonly stdout: (text: string) => void };
+
+export const formatTable = (rows: readonly TableRow[]): string => {
+  const widths = rows.reduce<number[]>(
+    (current, row) => row.map((cell, index) => Math.max(current[index] ?? 0, cell.length)),
+    [],
+  );
+  return rows
+    .map((row) =>
+      row
+        .map((cell, index) => cell.padEnd(widths[index] ?? cell.length))
+        .join("  ")
+        .trimEnd(),
+    )
+    .join("\n");
+};
+
+export const writeOutput = (io: TableIo, json: boolean, value: unknown, formatted: string): void => {
+  io.stdout(json ? JSON.stringify(value, null, 2) : formatted);
+};

package/src/cli/trainings.ts

@@ -14,6 +14,7 @@ import type {
 import type { BaseModelId, TrainingConfigurationInput } from "../../openapi/gen/models";
 import { assertCli, RETRY_OR_REPORT_HINT, TolokaCliError } from "./cli-error";
 import type { CliErrorHint } from "./cli-error";
+import { formatTable, type TableIo as TrainingIo, writeOutput } from "./table";
 
 const ESTIMATE_FILE_HINT: CliErrorHint = {
   description: "Regenerate it with toloka training cost <training> --json > <file>.",
@@ -49,28 +50,6 @@ type TrainingDraftApi = Pick<PotatoClient, "trainings" | "files" | "datasets">;
 type TrainingCostApi = Pick<PotatoClient, "trainings" | "waitFor">;
 type TrainingRunApi = Pick<PotatoClient, "trainings" | "waitFor">;
 const GISTING_PROMPT_MAX_BYTES = 256 * 1024;
-type TrainingIo = { readonly stdout: (text: string) => void };
-type TableRow = readonly string[];
-
-const formatTable = (rows: readonly TableRow[]): string => {
-  const widths = rows.reduce<number[]>(
-    (current, row) => row.map((cell, index) => Math.max(current[index] ?? 0, cell.length)),
-    [],
-  );
-  return rows
-    .map((row) =>
-      row
-        .map((cell, index) => cell.padEnd(widths[index] ?? cell.length))
-        .join("  ")
-        .trimEnd(),
-    )
-    .join("\n");
-};
-
-const writeOutput = (io: TrainingIo, json: boolean, value: unknown, formatted: string): void => {
-  io.stdout(json ? JSON.stringify(value, null, 2) : formatted);
-};
-
 const formatTraining = (training: Training): string =>
   formatTable([
     ["ID", training.id],

package/src/cli/version.ts

@@ -4,10 +4,13 @@ import { dirname, join, resolve, sep } from "node:path";
 
 import { SDK_VERSION } from "./sdk-version";
 import { assertCli, REPORT_HINT } from "./cli-error";
+import { isNativeCli } from "./native-runtime";
 
-export type CliInstallChannel = "global-registry" | "linked" | "project-local";
+export type CliInstallChannel = "native" | "global-registry" | "linked" | "project-local";
 
 type VersionInfoOptions = {
+  readonly native?: boolean;
+  readonly executablePath?: string;
   readonly globalBinDirectory?: string;
   readonly globalPackageDirectory?: string;
 };
@@ -36,6 +39,14 @@ const classifyInstallChannel = (
 };
 
 export const cliVersionInfo = (entryPath = process.argv[1], options: VersionInfoOptions = {}) => {
+  if (options.native ?? isNativeCli()) {
+    return {
+      version: SDK_VERSION,
+      commit: process.env.TOLOKA_BUILD_COMMIT ?? null,
+      channel: "native",
+      path: realpathOrSelf(options.executablePath ?? process.execPath),
+    };
+  }
   assertCli(entryPath, "CLI entry path is unavailable", { hint: REPORT_HINT });
   const globalBinDirectory =
     options.globalBinDirectory ??

package/src/client.ts

@@ -33,6 +33,7 @@ import type {
   ListPipelineRunsParams,
   ListProjectDatasetsParams,
   ListProjectPipelinesParams,
+  ListAudienceSpecializationsParams,
   ListProjectModelsParams,
   ListProjectsParams,
   ListTrainingRunsParams,
@@ -635,8 +636,24 @@ const createClientImplementation = (config: ClientConfig) => {
     list: async () => (await wire.listDeliveryOrders(requestOptions)).deliveryOrders,
   };
 
+  const audience = {
+    specializations: {
+      listPage: (params: ListAudienceSpecializationsParams = {}) =>
+        wire.listAudienceSpecializations(params, requestOptions),
+      listAll: (params: ListAudienceSpecializationsParams = {}) =>
+        listAllPages(async (pageOptions) => {
+          const page = await wire.listAudienceSpecializations(
+            { ...params, ...pageOptions },
+            requestOptions,
+          );
+          return { items: page.specializations, pagination: page.pagination };
+        }, params),
+    },
+  };
+
   return {
     me: () => wire.getCurrentUser(requestOptions),
+    audience,
     projects,
     pipelines,
     datasets,

package/src/index.ts

@@ -61,6 +61,7 @@ export type {
   RootNode,
   RootNodeSettings,
   RunStats,
+  Specialization,
 } from "../openapi/gen/models";
 export { PipelineGraphValidationError } from "./errors";
 export type { PipelineGraphValidationIssue } from "./errors";