@ykurilov/agent-chat-flows 0.0.0-stage → 0.55.0

package/dist/types/labels/editor.d.ts

@@ -0,0 +1,261 @@
+import type { FlowConditionType, FlowDataOp, FlowEventType, FlowFieldType, FlowTimerSpan, FlowTimerUnit } from "../format/flow-format.js";
+/** Надписи редактора сценария: доска, шапка, панели, прогон, окно JSON. */
+export interface FlowEditorLabels {
+    conditionKinds: Record<FlowConditionType, string>;
+    /** Подсказка к виду условия в легенде. */
+    conditionKindHints: Record<FlowConditionType, string>;
+    returnKind: string;
+    returnTarget: string;
+    ops: Record<FlowDataOp, string>;
+    events: Record<FlowEventType, string>;
+    timerSpans: Record<FlowTimerSpan | "time_of_day", string>;
+    units: Record<FlowTimerUnit, string>;
+    fieldTypes: Record<FlowFieldType, string>;
+    /** Значения поля «да/нет» в условиях и подписях. */
+    yes: string;
+    no: string;
+    /** «1 день», «3 дня», «5 дней». */
+    days: (count: number) => string;
+    /** Подпись условия «наступил день N программы» на доске: «с дня 3». */
+    programDay: (day: number) => string;
+    header: {
+        state: string;
+        card: string;
+        check: string;
+        run: string;
+        json: string;
+        save: string;
+        saved: string;
+        unsaved: string;
+        /** Сохранение отклонено: приложение отказало или упало. */
+        saveFailed: string;
+        saveFailedHint: string;
+        /** Плашка «только просмотр»: сценарий сейчас правит не человек. */
+        readOnly: string;
+        readOnlyHint: string;
+        migrate: string;
+    };
+    board: {
+        anyState: string;
+        start: string;
+        final: string;
+        noSideQuestions: string;
+        noTarget: string;
+        /** Условие словами, у которого ещё нет текста. */
+        emptyCondition: string;
+        /** Название нового состояния. */
+        newState: string;
+        zoomIn: string;
+        zoomOut: string;
+        fit: string;
+        /** «2 ошибки», «1 замечание». */
+        errors: (count: number) => string;
+        warnings: (count: number) => string;
+        /** Подпись касаний на карточке ноды: «касания 15 мин · 1 ч». */
+        nudges: string;
+        noNudges: string;
+        /** Срок своих касаний на карточке: «в день входа», «первые 2 дн.». */
+        nudgesDays: (days: number) => string;
+        /** Кнопки места на доске: легенда, мини-карта, панель «Сценарий», полный экран. */
+        space: {
+            legend: string;
+            showMinimap: string;
+            hideMinimap: string;
+            showInspector: string;
+            hideInspector: string;
+            enterFullscreen: string;
+            exitFullscreen: string;
+            /** Подпись области редактора в полном экране. */
+            fullscreenRegion: string;
+        };
+    };
+    overview: {
+        title: string;
+        common: string;
+        commonHint: string;
+        states: string;
+        exits: string;
+        finals: string;
+        lists: string;
+        help: string;
+        /** Находки без места: весь сценарий, «Дни и время». */
+        flowIssues: string;
+        afterEnd: string;
+        afterEndModes: Record<"reply" | "silent", string>;
+        afterEndHints: Record<"reply" | "silent", string>;
+    };
+    schedule: {
+        title: string;
+        on: string;
+        hint: string;
+        dayStart: string;
+        dayStartHint: string;
+        lengthDays: string;
+        lengthDaysNone: string;
+        nightFrom: string;
+        nightFromHint: string;
+        lateStart: string;
+        lateStartHint: string;
+        deadlineState: string;
+        deadlineNone: string;
+        farewell: string;
+        farewellText: string;
+        farewellTextHint: string;
+        firstMessages: string;
+        maxPerDay: string;
+        maxPerDayHint: string;
+        morning: string;
+        skipMorning: string;
+        nudges: string;
+        nudgesHint: string;
+        dayFrame: string;
+        dayFrameHint: string;
+        softFrom: string;
+        hardAt: string;
+        hardText: string;
+        hardTextHint: string;
+        more: string;
+    };
+    nudges: {
+        afterSilence: string;
+        addStep: string;
+        dailyAt: string;
+        addTime: string;
+        giveUpAfter: string;
+        never: string;
+        remove: string;
+        on: string;
+    };
+    sideTasks: {
+        title: string;
+        hint: string;
+        builtIn: string;
+        text: string;
+        when: string;
+        field: string;
+        noField: string;
+        fromApp: string;
+        maxAttempts: string;
+        perConversation: string;
+        add: string;
+        newTask: string;
+        delete: string;
+    };
+    statePanel: {
+        title: string;
+        name: string;
+        instructions: string;
+        instructionsHint: string;
+        firstMessage: string;
+        learn: string;
+        tools: string;
+        toolsHint: string;
+        noTools: string;
+        tags: string;
+        makeStart: string;
+        isStart: string;
+        noSideQuestions: string;
+        exits: string;
+        addExit: string;
+        more: string;
+        deleteState: string;
+        /** «Длится»: выход по времени в ноде. */
+        duration: string;
+        durationHint: string;
+        durationNone: string;
+        durationUnits: Record<"h" | "d" | "program_day", string>;
+        durationTo: string;
+        nudges: string;
+        nudgesModes: Record<"inherit" | "own" | "off", string>;
+        nudgesHint: string;
+        /** Сколько действуют свои касания: всё время в ноде или N дней с дня входа. */
+        nudgesDays: string;
+        nudgesDaysModes: Record<"always" | "days", string>;
+        nudgesDaysHint: string;
+    };
+    exitCard: {
+        when: string;
+        field: string;
+        op: string;
+        value: string;
+        event: string;
+        eventName: string;
+        timer: string;
+        amount: string;
+        at: string;
+        to: string;
+        moveUp: string;
+        moveDown: string;
+        delete: string;
+    };
+    anyStatePanel: {
+        title: string;
+        hint: string;
+        except: string;
+    };
+    cardPanel: {
+        title: string;
+        clientCard: string;
+        chatNotes: string;
+        chatNotesHint: string;
+        empty: string;
+        name: string;
+        about: string;
+        type: string;
+        options: string;
+        optionsHint: string;
+        refreshAfter: string;
+        /** «через 6 мес.». */
+        refreshAfterMonths: (months: number) => string;
+        pace: string;
+        /** «раз в 5 сообщений». */
+        paceEvery: (messages: number) => string;
+        paceHint: string;
+        addField: string;
+        newField: string;
+        /** Добавить поле из словаря приложения (`catalog.fields`). */
+        fromApp: string;
+    };
+    checkPanel: {
+        title: string;
+        clean: string;
+        errors: string;
+        warnings: string;
+        goTo: string;
+        /** Проверки приложения упали. */
+        appCheckFailed: string;
+    };
+    runPanel: {
+        title: string;
+        hint: string;
+        current: string;
+        whatHappened: string;
+        nothing: string;
+        known: string;
+        notYet: string;
+        nextQuestion: string;
+        path: string;
+        back: string;
+        restart: string;
+        finish: string;
+        /** «Прогон · шаг 3». */
+        step: (step: number) => string;
+        /** Цель выбора «ничего из этого». */
+        stay: string;
+        /** Выбор, который сейчас не сработает: нет цели или «назад» некуда. */
+        wontFire: string;
+        /** Шаг пути, когда ничего не сработало. */
+        nothingHappened: string;
+        noStart: string;
+    };
+    jsonDialog: {
+        title: string;
+        copy: string;
+        copied: string;
+        download: string;
+        load: string;
+        close: string;
+    };
+}
+export declare const russianFlowEditorLabels: FlowEditorLabels;
+export declare const englishFlowEditorLabels: FlowEditorLabels;

package/dist/types/labels/index.d.ts

@@ -0,0 +1,14 @@
+import { type ClientCardLabels } from "./client-card.js";
+import { type FlowEditorLabels } from "./editor.js";
+import { type FlowMigrateLabels } from "./migrate.js";
+import { type FlowTestChatLabels } from "./test-chat.js";
+/** Все надписи экранов сценария: по словарю на экран. */
+export interface FlowLabels {
+    editor: FlowEditorLabels;
+    clientCard: ClientCardLabels;
+    migrate: FlowMigrateLabels;
+    testChat: FlowTestChatLabels;
+}
+export declare const russianFlowLabels: FlowLabels;
+export declare const englishFlowLabels: FlowLabels;
+export type { ClientCardLabels, FlowEditorLabels, FlowMigrateLabels, FlowTestChatLabels };

package/dist/types/labels/migrate.d.ts

@@ -0,0 +1,19 @@
+/** Надписи окна перевода чатов на новую версию сценария. */
+export interface FlowMigrateLabels {
+    title: string;
+    hint: string;
+    version: string;
+    state: string;
+    chats: string;
+    removed: string;
+    target: string;
+    chooseTarget: string;
+    migrate: string;
+    /** «Переведено чатов: 12». */
+    moved: (count: number) => string;
+    nothingToMigrate: string;
+    close: string;
+    failed: string;
+}
+export declare const russianFlowMigrateLabels: FlowMigrateLabels;
+export declare const englishFlowMigrateLabels: FlowMigrateLabels;

package/dist/types/labels/test-chat.d.ts

@@ -0,0 +1,28 @@
+/** Надписи тестового чата редактора: живой разговор по сценарию с перемоткой часов. */
+export interface FlowTestChatLabels {
+    title: string;
+    state: string;
+    /** «+20 мин». */
+    advance: (label: string) => string;
+    clock: string;
+    /** Часы чата не сдвинуты. */
+    noOffset: string;
+    /** Единицы сдвига: «3 ч 20 мин». */
+    units: {
+        day: string;
+        hour: string;
+        minute: string;
+    };
+    reset: string;
+    close: string;
+    /** Тестовый чат не открылся или часы не перемотались. */
+    failed: string;
+    /** Перемотка к началу следующего дня сценария. */
+    nextDay: string;
+    /** «День 2 из 3», «День 2». */
+    day: (day: number, totalDays?: number) => string;
+    /** Вечер позднего старта: первый день ещё не начался. */
+    beforeFirstDay: string;
+}
+export declare const russianFlowTestChatLabels: FlowTestChatLabels;
+export declare const englishFlowTestChatLabels: FlowTestChatLabels;

package/dist/types/not-yet.d.ts

@@ -0,0 +1,2 @@
+/** Заглушка модуля, который появится на следующем этапе работ по сценариям. */
+export declare function notYet(stage: number, name: string): never;

package/dist/types/postgres.d.ts

@@ -0,0 +1,10 @@
+import type { Pool } from "pg";
+import { type PostgresFlowStore } from "./store/postgres.js";
+export type { PostgresFlowStore } from "./store/postgres.js";
+export { FLOWS_MIGRATIONS_TABLE, FLOWS_MIGRATION_LOCK_KEY } from "./store/migration-settings.js";
+export { flowChats, flowClientCards, flowFirstMessages, flowVersions } from "./store/postgres-schema.js";
+/**
+ * Сценарии в PostgreSQL на пуле приложения (схема `agent_chat`, та же база, что у хранилища чатов).
+ * Таблицы приводятся к последней миграции при первом обращении. Пул закрывает приложение.
+ */
+export declare function postgresFlowStore(pool: Pool): PostgresFlowStore;

package/dist/types/prompt/client-card-block.d.ts

@@ -0,0 +1,16 @@
+import type { AgentFlow } from "../format/flow-format.js";
+import type { FlowRun } from "../engine/flow-run.js";
+import type { ClientCardEntry, ClientFact } from "../store/flow-store.js";
+/** Значение поля готовой строкой: для блока модели, ответа `client_card` и экрана. */
+export declare function fieldValueText(value: unknown): string;
+/**
+ * Блок `flow:client`: что известно о человеке, что устарело, о чём можно спросить между делом. Известное и заметки идут
+ * по порядку полей сценария (порядок = что важнее). Значение не по типу поля считается неизвестным.
+ */
+export declare function clientCardBlock(input: {
+    flow: AgentFlow;
+    run: FlowRun;
+    card: ClientCardEntry[];
+    facts?: ClientFact[];
+    now: number;
+}): string;

package/dist/types/prompt/flow-rules.d.ts

@@ -0,0 +1,9 @@
+import type { AgentFlow } from "../format/flow-format.js";
+import type { FlowRulePart } from "./rules/rule-part.js";
+/** Части правил по возможностям сценария, по порядку. Каждую делает свой модуль. */
+export declare const FLOW_RULE_PARTS: readonly FlowRulePart[];
+/**
+ * Постоянная часть инструкции: как работает сценарий, правила такта, части по возможностям сценария и «Общее для всех
+ * состояний» версии чата. Сценарий без новых полей — текст как в 0.48.
+ */
+export declare function flowRules(common: string, flow?: AgentFlow, parts?: readonly FlowRulePart[]): string;

package/dist/types/prompt/rules/after-end.d.ts

@@ -0,0 +1,3 @@
+import type { AgentFlow } from "../../format/flow-format.js";
+/** Постоянные правила после конца разговора: вместо `flowRules`, когда чат закончен. От дня и места не зависят. */
+export declare function afterEndRules(flow: AgentFlow): string;

package/dist/types/prompt/rules/client-facts.d.ts

@@ -0,0 +1,2 @@
+import type { FlowRulePart } from "./rule-part.js";
+export declare const clientFactsRules: FlowRulePart;

package/dist/types/prompt/rules/day-frame.d.ts

@@ -0,0 +1,2 @@
+import type { FlowRulePart } from "./rule-part.js";
+export declare const dayFrameRules: FlowRulePart;

package/dist/types/prompt/rules/link-views.d.ts

@@ -0,0 +1,4 @@
+import type { FlowRulePart } from "./rule-part.js";
+/** Имя инструмента `createPersonLinkTool` из `@ykurilov/agent-chat-web-tools`. */
+export declare const PERSON_LINK_TOOL = "person_link_view";
+export declare const linkViewRules: FlowRulePart;

package/dist/types/prompt/rules/rule-part.d.ts

@@ -0,0 +1,3 @@
+import type { AgentFlow } from "../../format/flow-format.js";
+/** Часть постоянных правил сценария; не нужна этому сценарию — `null`. Текст зависит только от версии сценария (кэш). */
+export type FlowRulePart = (flow: AgentFlow) => string | null;

package/dist/types/prompt/rules/side-tasks.d.ts

@@ -0,0 +1,2 @@
+import type { FlowRulePart } from "./rule-part.js";
+export declare const sideTaskRules: FlowRulePart;

package/dist/types/prompt/rules/time-zone.d.ts

@@ -0,0 +1,2 @@
+import type { FlowRulePart } from "./rule-part.js";
+export declare const timeZoneRules: FlowRulePart;

package/dist/types/prompt/state-card.d.ts

@@ -0,0 +1,14 @@
+import type { AgentFlow } from "../format/flow-format.js";
+import type { FlowRun } from "../engine/flow-run.js";
+/** Условия словами состояния по порядку проверки (свои, потом общие): номер в карточке = место в этом списке + 1. */
+export declare function judgeExits(flow: AgentFlow, stateId: string): Array<{
+    exitId: string;
+    text: string;
+}>;
+/** Цель состояния: первая строка инструкции. */
+export declare function stateGoal(instructions: string): string;
+/**
+ * Блок `flow:state`: текущее состояние, цель, условия выхода, что узнать. Зависит только от состояния — пока оно то же,
+ * блок не меняется и в новые вопросы не дописывается (→ В9). Первого текста здесь нет: его несёт переход.
+ */
+export declare function stateCard(flow: AgentFlow, run: FlowRun): string;

package/dist/types/react/client-card/client-card-panel.d.ts

@@ -0,0 +1,8 @@
+import type { ClientCardSkin } from "../client-card-skin.js";
+import { type UseClientCardOptions } from "./use-client-card.js";
+export interface ClientCardScreenProps extends UseClientCardOptions {
+    /** Части экрана: `tandemClientCardSkin` из `@ykurilov/agent-chat-skin-tandem/client-card` или свои по договору. */
+    skin: ClientCardSkin;
+}
+/** Экран «Что агент знает о вас»: рядом с экраном памяти, если приложение его подключило. Надписи — `useFlowLabels().clientCard`. */
+export declare function ClientCardPanel({ skin, ...options }: ClientCardScreenProps): import("react").JSX.Element;

package/dist/types/react/client-card/index.d.ts

@@ -0,0 +1,2 @@
+export { ClientCardPanel, type ClientCardScreenProps } from "./client-card-panel.js";
+export { useClientCard, type UseClientCardOptions } from "./use-client-card.js";

package/dist/types/react/client-card/use-client-card.d.ts

@@ -0,0 +1,19 @@
+import type { ClientCardField } from "../../format/flow-format.js";
+import type { ClientCardEntry } from "../../store/flow-store.js";
+import type { ClientCardPanelProps } from "../client-card-skin.js";
+export interface UseClientCardOptions {
+    /** Поля карточки сценариев приложения: порядок = что важнее, имена видит человек. Чужих полей здесь может не быть — их покажет `id`. */
+    fields: Array<Pick<ClientCardField, "id" | "name" | "refreshAfterMonths">>;
+    /** Карточка человека с сервера: `flow.readClientCard(ownerId)` за HTTP-ручкой приложения. */
+    read(): Promise<ClientCardEntry[]>;
+    /** Стереть поле или `"all"`: `flow.forgetClientCard(ownerId, fieldId)`. */
+    forget(fieldId: string | "all"): Promise<void>;
+    /** Как назвать свободный факт о человеке («ведёт блог») в списке; по умолчанию — `useFlowLabels().clientCard.fact`. */
+    factName?: string;
+    /** Часы; для тестов. */
+    now?: () => number;
+    /** Пояс для даты записи; нет — пояс браузера. */
+    timeZone?: string;
+}
+/** Слой поведения экрана карточки: грузит, готовит строки для скина, стирает поле или всё. Скин только рисует. */
+export declare function useClientCard(options: UseClientCardOptions): ClientCardPanelProps;

package/dist/types/react/client-card-skin.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentType } from "react";
+export type ClientCardLoadState = "loading" | "ready" | "failed";
+export interface ClientCardFieldView {
+    fieldId: string;
+    name: string;
+    /** Значение готовой строкой. */
+    value: string;
+    /** Когда записано, готовой строкой («12.10.2026»). */
+    updatedAt: string;
+    /** Пора уточнить (`refreshAfterMonths` прошёл). */
+    stale: boolean;
+    /** Идёт стирание этого поля. */
+    busy: boolean;
+    onForget(): void;
+}
+export interface ClientCardPanelProps {
+    state: ClientCardLoadState;
+    fields: ClientCardFieldView[];
+    /** Идёт «стереть всё». */
+    forgettingAll: boolean;
+    /** Скин сам спрашивает подтверждение (`labels.forgetAllConfirm`) и только потом зовёт. */
+    onForgetAll(): void;
+    onRetry(): void;
+}
+export interface ClientCardSkin {
+    ClientCardPanel: ComponentType<ClientCardPanelProps>;
+}

package/dist/types/react/editor/board-space.d.ts

@@ -0,0 +1,51 @@
+import type { FlowEditorMode } from "../flow-editor-skin.js";
+import type { FlowSelection } from "./use-flow-editor.js";
+/** Шапка доски: `full` — логотип, название и кнопки; `compact` — одна узкая строка кнопок (название у приложения своё). */
+export type FlowHeaderMode = "full" | "compact";
+/** Легенда «Условия выхода»: свёрнута в кнопку, открыта или убрана совсем. */
+export type FlowLegendMode = "collapsed" | "open" | "hidden";
+/** Мини-карта: открыта, свёрнута в кнопку или убрана совсем. */
+export type FlowMinimapMode = "open" | "collapsed" | "hidden";
+/** Панель «Сценарий»: `open` — открыта, сворачивается кнопкой; `collapsible` — свёрнута, пока ничего не выбрано, выбор раскрывает. */
+export type FlowInspectorMode = "open" | "collapsible";
+export interface FlowBoardSpaceProps {
+    header?: FlowHeaderMode;
+    legend?: FlowLegendMode;
+    minimap?: FlowMinimapMode;
+    inspector?: FlowInspectorMode;
+    /** Кнопка «На весь экран» в шапке. По умолчанию есть. */
+    fullscreen?: boolean;
+    /** Ключ в localStorage для запомненного. По умолчанию общий `agent-chat-flow-board`; `null` — не запоминать. */
+    storageKey?: string | null;
+}
+export declare const DEFAULT_SPACE_STORAGE_KEY = "agent-chat-flow-board";
+export interface BoardSpace {
+    header: FlowHeaderMode;
+    legendHidden: boolean;
+    legendOpen: boolean;
+    toggleLegend(): void;
+    minimapHidden: boolean;
+    minimapOpen: boolean;
+    toggleMinimap(): void;
+    inspectorOpen: boolean;
+    /** Кнопка сворачивания панели нужна только в обычной правке: проверка и прогон держат панель открытой. */
+    inspectorToggleable: boolean;
+    toggleInspector(): void;
+    fullscreenAllowed: boolean;
+    fullscreen: boolean;
+    setFullscreen(on: boolean): void;
+}
+export declare function useBoardSpace(props: FlowBoardSpaceProps, editor: {
+    selection: FlowSelection;
+    mode: FlowEditorMode;
+}): BoardSpace;
+/**
+ * Полный экран: Esc выходит (если не открыто окно поверх), страница под редактором не прокручивается, Tab ходит по кругу
+ * внутри. Возвращает ссылку-обработчик клавиш для корня.
+ */
+export declare function useFullscreenBehavior(active: boolean, onExit: () => void, blocked: boolean, root: HTMLElement | null): (event: {
+    key: string;
+    shiftKey: boolean;
+    target: EventTarget;
+    preventDefault(): void;
+}) => void;

package/dist/types/react/editor/board-styles.d.ts

@@ -0,0 +1 @@
+export declare const FLOW_BOARD_CSS = "\n.react-flow { direction: ltr; position: relative; width: 100%; height: 100%; overflow: hidden; z-index: 0; }\n.react-flow__container, .react-flow__edgelabel-renderer, .react-flow__viewport-portal {\n  position: absolute; width: 100%; height: 100%; top: 0; left: 0;\n}\n.react-flow__pane { z-index: 1; touch-action: none; }\n.react-flow__pane.draggable { cursor: grab; }\n.react-flow__pane.dragging { cursor: grabbing; }\n.react-flow__viewport { transform-origin: 0 0; z-index: 2; pointer-events: none; }\n.react-flow__renderer { z-index: 4; }\n.react-flow__background { pointer-events: none; z-index: -1; }\n.react-flow__background-pattern.dots { fill: var(--flow-board-dots, rgba(128, 128, 128, 0.35)); }\n.react-flow .react-flow__edges { position: absolute; }\n.react-flow .react-flow__edges svg { overflow: visible; position: absolute; pointer-events: none; }\n.react-flow__edge { pointer-events: visibleStroke; }\n.react-flow__edge.inactive { pointer-events: none; }\n.react-flow__edge:focus, .react-flow__edge:focus-visible { outline: none; }\n.react-flow__connection { pointer-events: none; }\n.react-flow__connection-path { stroke: var(--flow-board-connection, currentColor); stroke-width: 2; fill: none; stroke-dasharray: 4 4; }\nsvg.react-flow__connectionline { z-index: 1001; overflow: visible; position: absolute; }\n.react-flow__nodes { pointer-events: none; transform-origin: 0 0; }\n.react-flow__node {\n  position: absolute; user-select: none; pointer-events: all; transform-origin: 0 0; box-sizing: border-box; cursor: default;\n}\n.react-flow__node.draggable { cursor: grab; }\n.react-flow__node.draggable.dragging { cursor: grabbing; }\n.react-flow__node:focus, .react-flow__node:focus-visible { outline: none; }\n.react-flow__handle {\n  position: absolute; pointer-events: none; width: 10px; height: 10px; min-width: 5px; min-height: 5px; border-radius: 999px;\n  background: var(--flow-board-handle-fill, #fff); border: 1.5px solid var(--flow-board-handle, currentColor);\n}\n.react-flow__handle.connectingfrom, .react-flow__handle.connectionindicator { pointer-events: all; cursor: crosshair; }\n.react-flow__handle-left { top: 50%; left: 0; transform: translate(-50%, -50%); }\n.react-flow__handle-right { top: 50%; right: 0; transform: translate(50%, -50%); }\n.react-flow__handle-top { top: 0; left: 50%; transform: translate(-50%, -50%); }\n.react-flow__handle-bottom { top: auto; bottom: 0; left: 50%; transform: translate(-50%, 50%); }\n.react-flow__panel { position: absolute; z-index: 5; margin: 16px; }\n.react-flow__panel.top { top: 0; }\n.react-flow__panel.bottom { bottom: 0; }\n.react-flow__panel.left { left: 0; }\n.react-flow__panel.right { right: 0; }\n.react-flow__panel.top.center, .react-flow__panel.bottom.center { left: 50%; transform: translateX(-16px) translateX(-50%); }\n.react-flow__minimap { background: var(--flow-board-minimap, #fff); border-radius: 12px; overflow: hidden; }\n.react-flow__minimap-svg { display: block; }\n.react-flow__minimap-mask { fill: var(--flow-board-minimap-mask, rgba(128, 128, 128, 0.15)); }\n.react-flow__minimap-node { fill: var(--flow-board-minimap-node, rgba(128, 128, 128, 0.35)); }\n.flow-board__new-exit.react-flow__handle {\n  top: auto; bottom: 10px; right: 0; transform: translate(50%, 0); opacity: 0.55;\n}\n.flow-board__new-exit.react-flow__handle:hover { opacity: 1; }\n@media (max-width: 860px) {\n  .flow-board__legend, .flow-board__minimap, .flow-board__minimap-toggle { display: none !important; }\n}\n";

package/dist/types/react/editor/editor-model.d.ts

@@ -0,0 +1,60 @@
+import { type AgentFlow, type ClientCardField, type FlowCondition, type FlowConditionType, type FlowPoint, type FlowState } from "../../format/flow-format.js";
+/** Чьё условие: id состояния или `null` — общие переходы «Из любого состояния». */
+export type ExitOwner = string | null;
+export type FieldList = "clientCard" | "chatNotes";
+export type StatePatch = Partial<Pick<FlowState, "title" | "instructions" | "firstMessage" | "learn" | "tools" | "tags" | "noSideQuestions">>;
+export declare function addState(flow: AgentFlow, input: {
+    title: string;
+    at?: FlowPoint;
+}): {
+    flow: AgentFlow;
+    stateId: string;
+};
+/** Удаляет состояние: ведущие в него условия остаются без цели, из старта и исключений оно уходит. */
+export declare function removeState(flow: AgentFlow, stateId: string): AgentFlow;
+export declare function updateState(flow: AgentFlow, stateId: string, patch: StatePatch): AgentFlow;
+export declare function setStart(flow: AgentFlow, stateId: string): AgentFlow;
+export declare function setExcept(flow: AgentFlow, except: string[]): AgentFlow;
+/** Условие нового вида со значениями по умолчанию; по данным — первое поле карточки или заметок. */
+export declare function defaultCondition(kind: FlowConditionType, flow: AgentFlow): FlowCondition;
+/**
+ * Условие после правки в карточке. Скин меняет одно поле, а целым и годным условие делает редактор: другой вид —
+ * значения по умолчанию; другое поле — сравнение, подходящее его типу; число из поля ввода — числом; таймер «время
+ * суток» ↔ «сколько прошло» — со своими значениями.
+ */
+export declare function normalizeCondition(flow: AgentFlow, previous: FlowCondition, next: FlowCondition): FlowCondition;
+export declare function addExit(flow: AgentFlow, owner: ExitOwner, kind: FlowConditionType): {
+    flow: AgentFlow;
+    exitId: string;
+};
+export declare function updateExit(flow: AgentFlow, owner: ExitOwner, exitId: string, next: {
+    when: FlowCondition;
+    to: string | null;
+}): AgentFlow;
+/** Стрелка с доски: условие ведёт в `to`. */
+export declare function connectExit(flow: AgentFlow, owner: ExitOwner, exitId: string, to: string): AgentFlow;
+export declare function moveExit(flow: AgentFlow, owner: ExitOwner, exitId: string, delta: number): AgentFlow;
+export declare function removeExit(flow: AgentFlow, owner: ExitOwner, exitId: string): AgentFlow;
+export declare function addField(flow: AgentFlow, list: FieldList, name: string): {
+    flow: AgentFlow;
+    fieldId: string;
+};
+export declare function updateField(flow: AgentFlow, list: FieldList, fieldId: string, patch: Partial<ClientCardField>): AgentFlow;
+export declare function moveField(flow: AgentFlow, list: FieldList, fieldId: string, delta: number): AgentFlow;
+/** Удаляет поле и его «узнать здесь». Условия по нему остаются: их покажет проверка графа. */
+export declare function removeField(flow: AgentFlow, list: FieldList, fieldId: string): AgentFlow;
+/** Где поставить новое состояние без места: под всеми узлами доски. */
+export declare function freeSpot(flow: AgentFlow): FlowPoint;
+/** Место узла на доске; `ANY_STATE_LAYOUT_KEY` — узел общих переходов. */
+export declare function placeNode(flow: AgentFlow, nodeId: string, at: FlowPoint): AgentFlow;
+/** JSON сценария для окна JSON и скачивания: без значений по умолчанию, как в файлах примеров. */
+export declare function flowToJson(flow: AgentFlow): string;
+export type LoadFlowResult = {
+    ok: true;
+    flow: AgentFlow;
+} | {
+    ok: false;
+    errors: string[];
+};
+/** Загрузка JSON в редактор: та же `parseFlow`, что на сервере. Ошибки — строками «место: что не так». */
+export declare function loadFlowJson(text: string): LoadFlowResult;

package/dist/types/react/editor/exit-text.d.ts

@@ -0,0 +1,11 @@
+import { type AgentFlow, type FlowCatalog, type FlowCondition, type FlowExit } from "../../format/flow-format.js";
+import type { FlowEditorLabels } from "../../labels/editor.js";
+import type { FlowEdgeKind } from "../flow-editor-skin.js";
+/** Подпись условия для доски, прогона и проверки: «Понятны тема курса и продажи», «Тишина человека 3 ч». С каталогом — подписи событий. */
+export declare function conditionText(flow: AgentFlow, when: FlowCondition, labels: FlowEditorLabels, catalog?: Pick<FlowCatalog, "events">): string;
+/** Вид стрелки: «назад» рисуется отдельно от вида условия. */
+export declare function edgeKind(exit: FlowExit): FlowEdgeKind;
+/** Название цели: состояние, «назад, где был» или `null`, если цель не выбрана или пропала. */
+export declare function targetTitle(flow: AgentFlow, to: string | null, labels: FlowEditorLabels): string | null;
+/** Цель состояния на доске: первая строка инструкции. */
+export declare function stateGoal(instructions: string): string;

package/dist/types/react/editor/flow-board.d.ts

@@ -0,0 +1,11 @@
+import type { FlowEditorSkin } from "../flow-editor-skin.js";
+import type { BoardSpace } from "./board-space.js";
+import type { FlowEditorController } from "./use-flow-editor.js";
+/** Ручка «новое условие» у каждого узла: потянуть — появится условие словами. */
+export declare const NEW_EXIT_HANDLE = "@new";
+/** Доска редактора. Свой `ReactFlowProvider`: другой сценарий — доска заново и «весь граф» в экран. */
+export declare function FlowBoard({ editor, skin, space }: {
+    editor: FlowEditorController;
+    skin: FlowEditorSkin;
+    space: BoardSpace;
+}): import("react").JSX.Element;

package/dist/types/react/editor/flow-editor.d.ts

@@ -0,0 +1,13 @@
+import { type CSSProperties } from "react";
+import type { FlowEditorSkin } from "../flow-editor-skin.js";
+import { type FlowBoardSpaceProps } from "./board-space.js";
+import { type UseFlowEditorOptions } from "./use-flow-editor.js";
+export interface FlowEditorProps extends UseFlowEditorOptions, FlowBoardSpaceProps {
+    /** Части экрана: `tandemFlowEditorSkin` из `@ykurilov/agent-chat-skin-tandem/flows` или свои по договору. */
+    skin: FlowEditorSkin;
+    /** Класс и стиль корня редактора. По умолчанию он занимает высоту родителя, но не меньше разумной (на телефоне тоже). */
+    className?: string;
+    style?: CSSProperties;
+}
+/** Редактор сценария: доска, панели, проверка, прогон, JSON. Управляемый: сценарий хранит приложение. */
+export declare function FlowEditor({ skin, className, style, header: headerMode, legend, minimap, inspector, fullscreen, storageKey, ...options }: FlowEditorProps): import("react").JSX.Element;