@smwb/onreel-git-mcp 0.11.0 → 0.13.0

package/dist/tracker/declarative/declarative-call.lib.d.ts

@@ -0,0 +1,28 @@
+import type { AdapterContext, JsonRequest, PageQuery, TrackerPage } from '../tracker.types.ts';
+import type { TrackerConfig } from './declarative.schema.ts';
+import type { ConfigCall, ConfigContext, ConfigSection, InputValues } from './declarative-model.types.ts';
+/** Отказы по ответу: 404 сущности и статусы «переход сейчас невозможен». */
+type CallOptions = Pick<JsonRequest, 'missing' | 'missingIsIssue' | 'conflictOn'>;
+/** Контекст запросов адаптера: обязательные поля подключения заданы, адрес API разобран, заголовки собраны. */
+export declare function contextOf(config: TrackerConfig, { connection, fetch }: AdapterContext): ConfigContext;
+/** Операция раздела из конфига; нет — undefined. */
+export declare function callOf(config: TrackerConfig, section: ConfigSection, name: string): ConfigCall | undefined;
+/** Операция, которой может не быть: нет в конфиге — отказ unsupported с тем, чего трекер не умеет. */
+export declare function requireCall(config: TrackerConfig, section: ConfigSection, name: string, what: string): ConfigCall;
+/**
+ * Входы со значением, которых нет в шаблонах операции, — отказ unsupported до запроса: молча потерянная правка хуже
+ * отказа. false и пустой список не считаются значением: это «не просили» (черновик, удаление ветки, меток нет).
+ */
+export declare function assertUsed(subject: string, call: ConfigCall, inputs: InputValues): void;
+/** Мс единой модели → ISO 8601 для шаблона; нет — нет. */
+export declare function isoOf(value: number | undefined): string | undefined;
+/** Входы сортировки: поле и направление (по умолчанию desc); сортировки нет — нет и входов. */
+export declare function sortInputs(sort: {
+    field: string;
+    direction?: 'asc' | 'desc' | undefined;
+} | undefined): InputValues;
+/** Операция с одним элементом результата. */
+export declare function single<T>(context: ConfigContext, call: ConfigCall, inputs: InputValues, options?: CallOptions, defaults?: Readonly<Record<string, unknown>>): Promise<T>;
+/** Операция-список: страница элементов единой модели (не больше limit) и курсор следующей. */
+export declare function list<T>(context: ConfigContext, call: ConfigCall, inputs: InputValues, page: PageQuery, options?: CallOptions, defaults?: Readonly<Record<string, unknown>>): Promise<TrackerPage<T>>;
+export {};

package/dist/tracker/declarative/declarative-capabilities.lib.d.ts

@@ -0,0 +1,20 @@
+import type { Issue, TrackerFeatures } from '../../contract/contract.types.ts';
+import type { CiJob, CiRun } from '../ci.schema.ts';
+import type { CiCapabilities, CiRunQuery } from '../ci.types.ts';
+import type { PullRequest } from '../pull.schema.ts';
+import type { PullRequestCapabilities, PullRequestQuery } from '../pull.types.ts';
+import type { CommentCapabilities, IssueCapabilities, IssueQuery } from '../tracker.types.ts';
+import type { TrackerConfig, TrackerConfigOperation } from './declarative.schema.ts';
+export declare function commentsOf(operation: TrackerConfigOperation | undefined): CommentCapabilities;
+export declare function issueCapabilitiesFrom(config: TrackerConfig): IssueCapabilities;
+/** Что умеет трекер для интерфейса: операции есть — действия есть; поля — по входам create и update. */
+export declare function featuresFrom(config: TrackerConfig): TrackerFeatures;
+export declare function pullCapabilitiesFrom(config: TrackerConfig): PullRequestCapabilities | undefined;
+export declare function ciCapabilitiesFrom(config: TrackerConfig): CiCapabilities | undefined;
+/** Проверка страницы задач по фильтрам clientSide запроса. */
+export declare function issueFilter(capabilities: IssueCapabilities, query: IssueQuery): (item: Issue) => boolean;
+export declare function pullFilter(capabilities: PullRequestCapabilities, query: PullRequestQuery): (item: PullRequest) => boolean;
+export declare function runFilter(capabilities: CiCapabilities, query: CiRunQuery): (item: CiRun) => boolean;
+export declare function jobFilter(capabilities: CiCapabilities, query: {
+    status?: readonly string[] | undefined;
+}): (item: CiJob) => boolean;

package/dist/tracker/declarative/declarative-ci.lib.d.ts

@@ -0,0 +1,4 @@
+import type { CiAdapter, CiCapabilities } from '../ci.types.ts';
+import type { AdapterContext } from '../tracker.types.ts';
+import type { TrackerConfig } from './declarative.schema.ts';
+export declare function createCiAdapter(config: TrackerConfig, adapterContext: AdapterContext, capabilities: CiCapabilities): CiAdapter;

package/dist/tracker/declarative/declarative-hint.const.d.ts

@@ -0,0 +1,4 @@
+/** Пример конфига `format: 1`: задачи, pull request-ы и CI трекера в стиле Gitea. */
+export declare const TRACKER_CONFIG_EXAMPLE = "format: 1\nkind: gitea\ntitle: Gitea\nfields:\n  - { name: url, required: true, secret: false }\n  - { name: target, required: true, secret: false }\n  - { name: token, required: true, secret: true }\nhttp:\n  base: \"{{url}}/api/v1\"\n  auth: { kind: bearer }\n  headers:\n    Accept: application/json\n  pagination: { style: page, page: page, size: limit, next: link }\nissues:\n  list:\n    path: \"/repos/{{target|path}}/issues\"\n    query:\n      type: issues\n      state: \"{{status}}\"\n      labels: \"{{labels}}\"\n      q: \"{{search}}\"\n      created_by: \"{{author}}\"\n      since: \"{{updatedAfter}}\"\n      before: \"{{updatedBefore}}\"\n    inputs:\n      status: { open: open, in_progress: open, done: closed, declined: closed, \"*\": all }\n    result: &issue\n      key: $.number\n      title: $.title\n      description: $.body\n      status.category: { path: $.state, map: { open: open, closed: done } }\n      labels: $.labels[*].name\n      assignee: $.assignee.login\n      url: $.html_url\n      createdAt: $.created_at\n      updatedAt: $.updated_at\n  get:\n    path: \"/repos/{{target|path}}/issues/{{key}}\"\n    result: *issue\n  create:\n    method: POST\n    path: \"/repos/{{target|path}}/issues\"\n    body:\n      title: \"{{title}}\"\n      body: \"{{description}}\"\n      assignee: \"{{assignee}}\"\n    result: *issue\n  update:\n    method: PATCH\n    path: \"/repos/{{target|path}}/issues/{{key}}\"\n    body:\n      title: \"{{title}}\"\n      body: \"{{description}}\"\n      state: \"{{status}}\"\n      assignee: \"{{assignee}}\"\n    inputs:\n      status: { open: open, done: closed }\n    result: *issue\n  comments:\n    path: \"/repos/{{target|path}}/issues/{{key}}/comments\"\n    query:\n      since: \"{{updatedAfter}}\"\n    result: &comment\n      id: $.id\n      author: $.user.login\n      body: $.body\n      createdAt: $.created_at\n  comment:\n    method: POST\n    path: \"/repos/{{target|path}}/issues/{{key}}/comments\"\n    body:\n      body: \"{{body}}\"\n    result: *comment\npulls:\n  list:\n    path: \"/repos/{{target|path}}/pulls\"\n    query:\n      state: \"{{status}}\"\n    inputs:\n      status: { draft: open, open: open, merged: closed, closed: closed, \"*\": all }\n    result: &pull\n      key: $.number\n      title: $.title\n      description: $.body\n      status.category: { path: $.state, map: { open: open, closed: closed } }\n      merged: $.merged\n      draft: $.draft\n      author: $.user.login\n      source: $.head.ref\n      target: $.base.ref\n      headSha: $.head.sha\n      labels: $.labels[*].name\n      url: $.html_url\n      createdAt: $.created_at\n      updatedAt: $.updated_at\n      mergedAt: $.merged_at\n      closedAt: $.closed_at\n  get:\n    path: \"/repos/{{target|path}}/pulls/{{key}}\"\n    result: *pull\n  create:\n    method: POST\n    path: \"/repos/{{target|path}}/pulls\"\n    body:\n      title: \"{{title}}\"\n      body: \"{{description}}\"\n      head: \"{{sourceBranch}}\"\n      base: \"{{targetBranch}}\"\n    result: *pull\n  update:\n    method: PATCH\n    path: \"/repos/{{target|path}}/pulls/{{key}}\"\n    body:\n      title: \"{{title}}\"\n      body: \"{{description}}\"\n      base: \"{{targetBranch}}\"\n      state: \"{{status}}\"\n    inputs:\n      status: { open: open, closed: closed }\n    result: *pull\n  merge:\n    method: POST\n    path: \"/repos/{{target|path}}/pulls/{{key}}/merge\"\n    body:\n      Do: \"{{method}}\"\n      merge_message_field: \"{{message}}\"\n      delete_branch_after_merge: \"{{deleteSource}}\"\n      head_commit_id: \"{{headSha}}\"\n  comments:\n    path: \"/repos/{{target|path}}/issues/{{key}}/comments\"\n    result: *comment\n  comment:\n    method: POST\n    path: \"/repos/{{target|path}}/issues/{{key}}/comments\"\n    body:\n      body: \"{{body}}\"\n    result: *comment\nci:\n  workflows:\n    path: \"/repos/{{target|path}}/actions/workflows\"\n    items: $.workflows\n    result:\n      key: $.id\n      name: $.name\n      path: $.path\n      enabled: { path: $.state, map: { active: true }, default: false }\n  runs:\n    path: \"/repos/{{target|path}}/actions/runs\"\n    query:\n      branch: \"{{ref}}\"\n      event: \"{{event}}\"\n      status: \"{{status}}\"\n      actor: \"{{actor}}\"\n      head_sha: \"{{sha}}\"\n    inputs:\n      event: { push: push, pull_request: pull_request, manual: workflow_dispatch, schedule: schedule }\n      status: { queued: queued, waiting: waiting, running: in_progress, success: success, failed: failure, canceled: cancelled, skipped: skipped }\n    items: $.workflow_runs\n    result: &run\n      key: $.id\n      number: $.run_number\n      workflows: $.path\n      status.category: &state\n        - { path: $.conclusion, map: { success: success, failure: failed, cancelled: canceled, skipped: skipped }, default: failed }\n        - { path: $.status, map: { queued: queued, waiting: waiting, in_progress: running }, default: running }\n      status.name: $.status\n      event.category: { path: $.event, map: { push: push, pull_request: pull_request, workflow_dispatch: manual, schedule: schedule }, default: other }\n      ref: $.head_branch\n      sha: $.head_sha\n      actor: $.actor.login\n      attempt: $.run_attempt\n      url: $.html_url\n      createdAt: $.created_at\n      startedAt: $.run_started_at\n      finishedAt: $.completed_at\n      updatedAt: $.updated_at\n  run:\n    path: \"/repos/{{target|path}}/actions/runs/{{key}}\"\n    result: *run\n  jobs:\n    path: \"/repos/{{target|path}}/actions/runs/{{run}}/jobs\"\n    items: $.jobs\n    result: &job\n      key: $.id\n      runKey: $.run_id\n      name: $.name\n      status.category: *state\n      status.name: $.status\n      url: $.html_url\n      startedAt: $.started_at\n      finishedAt: $.completed_at\n  job:\n    path: \"/repos/{{target|path}}/actions/jobs/{{key}}\"\n    result: *job\n  log:\n    path: \"/repos/{{target|path}}/actions/jobs/{{key}}/logs\"\n  trigger:\n    method: POST\n    path: \"/repos/{{target|path}}/actions/workflows/{{workflow}}/dispatches\"\n    body:\n      ref: \"{{ref}}\"\n      inputs: \"{{inputs}}\"\n  rerun:\n    method: POST\n    path: \"/repos/{{target|path}}/actions/runs/{{key}}/rerun\"\n  cancel:\n    method: POST\n    path: \"/repos/{{target|path}}/actions/runs/{{key}}/cancel\"\n";
+/** Подсказка агенту: как написать конфиг своего трекера, правила безопасности и рабочий пример. */
+export declare const TRACKER_CONFIG_HINT: string;

package/dist/tracker/declarative/declarative-issues.lib.d.ts

@@ -0,0 +1,5 @@
+import type { TrackerFeatures } from '../../contract/contract.types.ts';
+import type { AdapterContext, IssueCapabilities, TrackerAdapter } from '../tracker.types.ts';
+import type { TrackerConfig } from './declarative.schema.ts';
+/** Адаптер задач по разделу issues; раздела нет — каждый метод отказывает unsupported. */
+export declare function createIssuesAdapter(config: TrackerConfig, adapterContext: AdapterContext, capabilities: IssueCapabilities, features: TrackerFeatures): TrackerAdapter;

package/dist/tracker/declarative/declarative-model.const.d.ts

@@ -0,0 +1,40 @@
+import type { ConfigSection, OperationSpec, ResultField, ResultModel } from './declarative-model.types.ts';
+/** Плейсхолдер шаблона: `{{имя}}` — значение кодируется по месту, `{{имя|path}}` — путь из сегментов через «/». */
+export declare const PLACEHOLDER: RegExp;
+/** Поля подключения, которые подставляют шаблоны; токена среди них нет — его подставляет только http.auth. */
+export declare const CONNECTION_PLACEHOLDERS: readonly ['url', 'target', 'user'];
+/** Заголовки, которые задаёт сам клиент HTTP: в http.headers их нет. */
+export declare const RESERVED_HEADERS: readonly ['host', 'content-length', 'content-type', 'transfer-encoding', 'connection', 'accept-encoding', 'te', 'upgrade', 'trailer'];
+/** Ключи, которые не бывают именами в конфиге: они меняли бы прототип объекта. */
+export declare const FORBIDDEN_KEYS: readonly ['__proto__', 'constructor', 'prototype'];
+/** Сообщение «секрет в тексте конфига»: токен вводят в подключении, а не пишут в конфиг. */
+export declare const SECRET_IN_CONFIG = "\u043F\u043E\u0445\u043E\u0436\u0435 \u043D\u0430 \u0441\u0435\u043A\u0440\u0435\u0442: \u0442\u043E\u043A\u0435\u043D \u043D\u0435 \u043F\u0438\u0448\u0443\u0442 \u0432 \u043A\u043E\u043D\u0444\u0438\u0433 \u2014 \u0435\u0433\u043E \u0432\u0432\u043E\u0434\u044F\u0442 \u0432 \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0435\u043D\u0438\u0438 \u043F\u0440\u043E\u0435\u043A\u0442\u0430, \u0430 \u043F\u043E\u0434\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E http.auth";
+/** Ключ таблицы входа: значение для нескольких разных значений сразу (все статусы); только у фильтров списков. */
+export declare const INPUT_ANY = "*";
+/** Ключ таблицы входа для null: «без исполнителя» в фильтре и «снять исполнителя» в правке. */
+export declare const INPUT_NULL = "null";
+/**
+ * Операции разделов: входы, обязательные входы и что делать с ответом. Ветки PR во входах — sourceBranch и
+ * targetBranch: имя target занято полем подключения (репозиторий), а в модели PR они — source и target.
+ */
+export declare const OPERATIONS: Readonly<Record<ConfigSection, Readonly<Record<string, OperationSpec>>>>;
+/** Операции, без которых раздела нет. */
+export declare const REQUIRED_OPERATIONS: Readonly<Record<ConfigSection, readonly string[]>>;
+/** Операции CI, которым нужны другие: лог читает состояние задания, перезапуск и отмена перечитывают прогон или задание. */
+export declare const CI_OPERATION_NEEDS: Readonly<Record<string, readonly string[]>>;
+/** Области значений входов: ключи таблиц `inputs` — только из них; вход без области таблицы не имеет (кроме null у assignee). */
+export declare const INPUT_DOMAINS: Readonly<Record<ConfigSection, Readonly<Record<string, readonly string[]>>>>;
+/** Входы-списки фильтров, у таблиц которых бывает ключ `*`: несколько разных значений сразу. */
+export declare const WILDCARD_INPUTS: readonly ['status', 'event'];
+/** Входы-словари: подставляются только целым значением тела (входы запуска CI). */
+export declare const OBJECT_INPUTS: readonly ['inputs'];
+/** Входы-времена (мс единой модели): в шаблон уходят строкой ISO 8601 UTC. */
+export declare const TIME_INPUTS: readonly ["createdAfter", "createdBefore", "updatedAfter", "updatedBefore"];
+/**
+ * Поля результата по моделям. Вложенные поля — через точку (`status.category`); url — первая ссылка links.
+ * У PR флаги merged и draft — не поля модели: merged (или время mergedAt) делает категорию merged, draft —
+ * draft у открытого PR, для API, где состояние — open/closed и отдельные флаги.
+ */
+export declare const RESULT_FIELDS: Readonly<Record<ResultModel, Readonly<Record<string, ResultField>>>>;
+/** Поля результата, обязательные только у некоторых операций: задание само по себе должно знать свой прогон. */
+export declare const OPERATION_REQUIRED_FIELDS: Readonly<Record<string, readonly string[]>>;

package/dist/tracker/declarative/declarative-model.types.d.ts

@@ -0,0 +1,87 @@
+import type { TrackerConfig, TrackerConfigOperation } from './declarative.schema.ts';
+import type { TrackerConfigIssue } from './declarative.types.ts';
+import type { TrackerFetch } from '../tracker.types.ts';
+/** Раздел конфига: задачи, pull request-ы или CI. */
+export type ConfigSection = 'issues' | 'pulls' | 'ci';
+/** Модель результата операции: элемент единой модели, который собирает интерпретатор. */
+export type ResultModel = 'issue' | 'comment' | 'pull' | 'run' | 'job' | 'workflow';
+/** Вид значения поля единой модели в результате операции. */
+export type ResultFieldType = 
+/** Идентификатор: строка или число ответа становится строкой. */
+'id' | 'text'
+/** Целое число от 0 (или от 1 при positive). */
+ | 'int' | 'flag'
+/** Время ISO 8601 или число: меньше 10^11 — секунды Unix, иначе миллисекунды. */
+ | 'time'
+/** Список строк: обычно путь с `[*]`. */
+ | 'list'
+/** Адрес страницы http(s): становится первой ссылкой links. */
+ | 'link'
+/** Значение из перечня единой модели, обычно через map. */
+ | 'enum'
+/** Коммит: 7–64 hex, приводится к нижнему регистру. */
+ | 'sha';
+export type ResultField = {
+    type: ResultFieldType;
+    /** Потолок длины строки (у list — каждого элемента): длиннее — обрезается. */
+    max?: number;
+    /** Потолок числа элементов list. */
+    count?: number;
+    values?: readonly string[];
+    /** Без этого поля элемент единой модели не собрать: правило конфига требует его в result. */
+    required?: boolean;
+    /** Пустая строка — значение (тело комментария), а не «нет поля». */
+    empty?: boolean;
+    positive?: boolean;
+};
+/** Что интерпретатор делает с ответом операции. */
+export type OperationSpec = {
+    /** Входы операции — имена плейсхолдеров и таблиц значений. */
+    inputs: readonly string[];
+    /** Входы, без которых операция не имеет смысла: шаблоны обязаны их использовать. */
+    required: readonly string[];
+    /** Модель результата; нет — ответ — текст лога (log) или не читается (после неё элемент перечитывается). */
+    model?: ResultModel;
+    /** Ответ — список элементов со страницами. */
+    list?: boolean;
+    /** result: обязателен, по желанию (нет — элемент перечитывается) или запрещён. */
+    result: 'required' | 'optional' | 'forbidden';
+    /** Ответ — текст (лог задания CI). */
+    text?: boolean;
+};
+/** Значение входа операции: строка, число, флаг, список строк, словарь (входы запуска CI); null — «нет значения» API. */
+export type InputValue = string | number | boolean | null | readonly string[] | Readonly<Record<string, string>> | undefined;
+/** Входы вызова операции по именам. */
+export type InputValues = Readonly<Record<string, InputValue>>;
+/** Адрес API подключения: база без хвостовых «/», её origin и путь — все запросы остаются под ними. */
+export type ConfigBase = {
+    base: string;
+    origin: string;
+    path: string;
+};
+/** Всё, что нужно запросам одного адаптера: конфиг, подключение, адрес базы, fetch и заголовки. */
+export type ConfigContext = {
+    config: TrackerConfig;
+    connection: {
+        url?: string | undefined;
+        target?: string | undefined;
+        user?: string | undefined;
+    };
+    base: ConfigBase;
+    fetch: TrackerFetch;
+    /** Постоянные заголовки и авторизация, имена в нижнем регистре. */
+    headers: Record<string, string>;
+};
+/** Операция, которую вызывает адаптер: раздел и имя — для текстов ошибок, сама операция и её описание. */
+export type ConfigCall = {
+    section: ConfigSection;
+    name: string;
+    operation: TrackerConfigOperation;
+    spec: OperationSpec;
+};
+/** Итог разбора входа: данные для схемы (нет — дальше проверять нечего) и ошибки; secret — среди ошибок секрет в тексте. */
+export type ParsedInput = {
+    data?: unknown;
+    issues: TrackerConfigIssue[];
+    secret: boolean;
+};

package/dist/tracker/declarative/declarative-parse.lib.d.ts

@@ -0,0 +1,7 @@
+import type { TrackerConfigIssue } from './declarative.types.ts';
+import type { ParsedInput } from './declarative-model.types.ts';
+type Path = readonly (string | number)[];
+export declare function issueAt(path: Path, message: string): TrackerConfigIssue;
+/** Вход конфига: текст YAML (JSON — тоже YAML) или уже разобранный объект. */
+export declare function parseConfigInput(input: unknown): ParsedInput;
+export {};

package/dist/tracker/declarative/declarative-pull.lib.d.ts

@@ -0,0 +1,4 @@
+import type { PullRequestAdapter, PullRequestCapabilities } from '../pull.types.ts';
+import type { AdapterContext } from '../tracker.types.ts';
+import type { TrackerConfig } from './declarative.schema.ts';
+export declare function createPullAdapter(config: TrackerConfig, adapterContext: AdapterContext, capabilities: PullRequestCapabilities): PullRequestAdapter;

package/dist/tracker/declarative/declarative-request.lib.d.ts

@@ -0,0 +1,49 @@
+import type { JsonRequest, JsonResponse, PageQuery, TextRequest, TextResponse } from '../tracker.types.ts';
+import type { TrackerConfig, TrackerConfigPagination } from './declarative.schema.ts';
+import type { TrackerConfigBodyValue } from './declarative.types.ts';
+import type { ConfigBase, ConfigCall, ConfigContext, InputValues } from './declarative-model.types.ts';
+/** Плейсхолдер шаблона: имя и модификатор (`path`). */
+type Placeholder = {
+    name: string;
+    modifier: string | undefined;
+};
+export declare function placeholdersOf(template: string): Placeholder[];
+/** Шаблон — ровно один плейсхолдер без модификатора: в теле значение сохраняет тип (флаг, список, null, словарь). */
+export declare function wholePlaceholder(template: string): string | undefined;
+/** Шаблоны тела запроса (строки на любой глубине). */
+export declare function bodyTemplates(value: TrackerConfigBodyValue | undefined): string[];
+/** Имена всех плейсхолдеров операции: пути, query и тела. */
+export declare function usedNames(operation: ConfigCall['operation'] | undefined): Set<string>;
+/**
+ * Адрес API подключения: http.base, где `{{url}}` в начале — url подключения без хвостовых «/». Правило конфига
+ * держит остальное литералом, начинающимся с «/»: url задаёт origin, конфиг — только путь под ним.
+ */
+export declare function baseOf(config: TrackerConfig, connection: {
+    url?: string | undefined;
+}): ConfigBase;
+/**
+ * Входы после таблиц значений операции: значение единой модели → значение API. Нет значения в таблице — отказ
+ * unsupported, а у фильтра списка с ключом `*` — значение `*` (лишнее отсеет проверка страницы). Список значений:
+ * одно после таблицы — оно, несколько — `*`, если он есть, иначе список. null — ключ таблицы `null`.
+ */
+export declare function mapInputs(title: string, call: ConfigCall, inputs: InputValues): InputValues;
+/** Заголовки подключения: постоянные из http.headers (имена в нижнем регистре) и авторизация токеном. */
+export declare function headersOf(config: TrackerConfig, connection: ConfigContext['connection'] & {
+    token?: string | undefined;
+}): Record<string, string>;
+/** Одна операция с ответом JSON. */
+export declare function callJson(context: ConfigContext, call: ConfigCall, inputs: InputValues, options?: Pick<JsonRequest, 'missing' | 'missingIsIssue' | 'conflictOn'> & {
+    params?: readonly (readonly [string, string])[];
+}): Promise<JsonResponse>;
+/** Одна операция с текстовым ответом (лог): accept — текстовый, а не постоянный заголовок конфига. */
+export declare function callText(context: ConfigContext, call: ConfigCall, inputs: InputValues, options: Pick<TextRequest, 'skip' | 'keep' | 'missing'>): Promise<TextResponse>;
+/** Постраничность операции: своя или http.pagination. */
+export declare function paginationOf(context: ConfigContext, call: ConfigCall): TrackerConfigPagination;
+/** Параметры страницы и номер (у style: page). Курсор не того вида — invalid_request. */
+export declare function pageParams(title: string, pagination: TrackerConfigPagination, page: PageQuery): {
+    params: [string, string][];
+    number: number;
+};
+/** Курсор следующей страницы по ответу; нет — undefined. count — сколько элементов пришло (до проверки страницы). */
+export declare function nextCursorOf(pagination: TrackerConfigPagination, page: PageQuery, number: number, count: number, response: JsonResponse): string | undefined;
+export {};

package/dist/tracker/declarative/declarative-result.lib.d.ts

@@ -0,0 +1,11 @@
+import { TrackerError } from '../tracker.lib.ts';
+import type { ConfigCall } from './declarative-model.types.ts';
+/** Значение по пути JSON; путь с `[*]` даёт список найденного (без null), без него — одно значение или undefined. */
+export declare function readPath(path: string, value: unknown): unknown;
+/** Ошибка разбора ответа: failed с операцией и полем; текст без секретов. */
+export declare function answerFailed(title: string, call: ConfigCall, detail: string): TrackerError;
+/**
+ * Элемент ответа → объект единой модели по result операции, проверенный схемой модели. defaults — поля, которые
+ * знает вызов, а не ответ (runKey задания из списка заданий прогона).
+ */
+export declare function buildItem(title: string, call: ConfigCall, element: unknown, defaults?: Readonly<Record<string, unknown>>): unknown;

package/dist/tracker/declarative/declarative-rules.lib.d.ts

@@ -0,0 +1,4 @@
+import type { TrackerConfig } from './declarative.schema.ts';
+import type { TrackerConfigIssue } from './declarative.types.ts';
+/** Правила конфига, которых не выражает схема; пусто — конфиг годен. */
+export declare function configIssues(config: TrackerConfig): TrackerConfigIssue[];

package/dist/tracker/declarative/declarative.const.d.ts

@@ -0,0 +1,10 @@
+/** Предел размера конфига, байт: текста YAML в UTF-8 или JSON уже разобранного объекта. */
+export declare const TRACKER_CONFIG_MAX_BYTES: number;
+/** Сколько ошибок конфига отдаёт проверка: остальные отсекаются. */
+export declare const TRACKER_CONFIG_ISSUES_MAX = 100;
+/** Предел ссылок YAML на якоря: повтор блока допустим, «бомба» из вложенных ссылок — нет. */
+export declare const TRACKER_CONFIG_YAML_ALIAS_MAX = 100;
+/** Предел вложенности объектов и списков конфига. */
+export declare const TRACKER_CONFIG_DEPTH_MAX = 16;
+/** Виды встроенных трекеров библиотеки: конфиг их не занимает. */
+export declare const BUILTIN_TRACKER_KINDS: readonly ['local', 'sourcecraft', 'github', 'gitlab', 'jira'];

package/dist/tracker/declarative/declarative.lib.d.ts

@@ -0,0 +1,19 @@
+import type { TrackerConfigCheck, TrackerConfigIssue } from './declarative.types.ts';
+import type { TrackerDefinition } from '../tracker.types.ts';
+/** Конфиг не прошёл проверку: issues — ошибки с путями (не больше TRACKER_CONFIG_ISSUES_MAX). */
+export declare class TrackerConfigError extends Error {
+    readonly issues: readonly TrackerConfigIssue[];
+    readonly secret: boolean;
+    constructor(issues: readonly TrackerConfigIssue[], secret: boolean);
+}
+/**
+ * Проверка конфига без побочных эффектов: размер, YAML, секреты в тексте, схема и правила. Все ошибки сразу —
+ * каждая с путём поля; secret — среди них секрет в тексте (такой конфиг не сохраняют, токен вводят в подключении).
+ */
+export declare function validateTrackerConfig(input: unknown): TrackerConfigCheck;
+/**
+ * Определение трекера из конфига: descriptor с source 'user', возможности, выведенные из операций, разделы pulls
+ * и ci, если они описаны, и origin(connection) — origin http.base. Неверный конфиг — TrackerConfigError.
+ * Каждый ответ API проходит схему единой модели; запросы идут через requestJson/requestText с origin базы.
+ */
+export declare function definitionFromConfig(input: unknown): TrackerDefinition;