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

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

@@ -0,0 +1,44 @@
+import { type AgentFlow } from "../../format/flow-format.js";
+import type { FlowRun } from "../../engine/flow-run.js";
+/** Шаг пути прогона: куда пришли и по какому условию; `nothing` — «ничего из этого», агент остался. */
+export interface SimulationStep {
+    stateId: string;
+    exitId: string | null;
+    nothing: boolean;
+}
+export interface Simulation {
+    run: FlowRun;
+    /** Карточка клиента в прогоне: id поля → значение и когда записано. */
+    card: Record<string, {
+        value: unknown;
+        updatedAt: number;
+    }>;
+    now: number;
+    timeZone: string;
+    steps: SimulationStep[];
+    /** Прогон до последнего шага — для «шаг назад». */
+    previous: Simulation | null;
+}
+/** Выбор «что произошло»: условие и куда приведёт движок (`null` — не сработает). */
+export interface SimulationChoice {
+    exitId: string;
+    own: boolean;
+    target: string | null;
+}
+export declare function startSimulation(flow: AgentFlow, options: {
+    now: number;
+    timeZone: string;
+}): Simulation;
+export declare function simulationChoices(flow: AgentFlow, sim: Simulation): SimulationChoice[];
+/** Автор выбрал условие: собираем событие, на которое оно срабатывает, и отдаём движку. */
+export declare function chooseExit(flow: AgentFlow, sim: Simulation, exitId: string): Simulation;
+/** «Ничего из этого»: человек написал, агент ответил, остались в том же состоянии. */
+export declare function chooseNothing(flow: AgentFlow, sim: Simulation): Simulation;
+/**
+ * Автор вписал, что агент знает о человеке. Число — для числовых полей; пусто — поле забыто. Если от этого сработало
+ * условие по данным — переход, как в рабочем чате.
+ */
+export declare function setKnownValue(flow: AgentFlow, sim: Simulation, fieldId: string, text: string): Simulation;
+/** id поля, о котором агент спросит сейчас; `null` — ни о чём. */
+export declare function nextQuestionField(flow: AgentFlow, sim: Simulation): string | null;
+export declare function stepBack(sim: Simulation): Simulation;

package/dist/types/react/editor/index.d.ts

@@ -0,0 +1,6 @@
+export { FlowEditor, type FlowEditorProps } from "./flow-editor.js";
+export { useFlowEditor, type FlowDialog, type FlowEditorController, type FlowMigrateController, type FlowMigrateRow, type FlowMigration, type FlowSaveResult, type FlowSelection, type UseFlowEditorOptions, } from "./use-flow-editor.js";
+export { conditionText } from "./exit-text.js";
+export { chooseExit, chooseNothing, nextQuestionField, setKnownValue, simulationChoices, startSimulation, stepBack, type Simulation, type SimulationChoice, type SimulationStep, } from "./flow-simulation.js";
+export { DEFAULT_NUDGES, DEFAULT_SCHEDULE } from "./schedule-model.js";
+export type { FlowBoardSpaceProps, FlowHeaderMode, FlowInspectorMode, FlowLegendMode, FlowMinimapMode } from "./board-space.js";

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

@@ -0,0 +1,47 @@
+import { type AgentFlow, type FlowAfterEnd, type FlowDuration, type FlowNudges, type FlowSchedule, type FlowState } from "../../format/flow-format.js";
+import type { FlowEditorLabels } from "../../labels/editor.js";
+/** «Дни и время» при включении: день с 9:00, порог позднего старта по умолчанию, без прощания. */
+export declare const DEFAULT_SCHEDULE: FlowSchedule;
+/** Свои касания ноды без общего образца: 15 мин · 1 ч · 4 ч тишины. */
+export declare const DEFAULT_NUDGES: FlowNudges;
+export declare function setScheduleOn(flow: AgentFlow, on: boolean): AgentFlow;
+export type SchedulePatch = {
+    [K in keyof FlowSchedule]?: FlowSchedule[K] | undefined;
+};
+/** Правка «Дней и времени»: `undefined` и пустая строка убирают поле, пустые вложенные разделы — целиком. */
+export declare function updateSchedule(flow: AgentFlow, patch: SchedulePatch): AgentFlow;
+export declare function setAfterEnd(flow: AgentFlow, mode: FlowAfterEnd): AgentFlow;
+export type DurationUnit = "h" | "d" | "program_day";
+/**
+ * Продолжительность ноды: выход «длится N дней сценария» (`state_days`), «до дня N программы» (`program_day`, `amount` —
+ * номер дня) или «N часов в этом состоянии».
+ */
+export interface StateDuration {
+    exitId: string;
+    amount: number;
+    unit: DurationUnit;
+    to: string | null;
+}
+/** Первый выход-продолжительность ноды; минуты «в этом состоянии» — обычный таймер, не «Длится». */
+export declare function durationOf(state: FlowState): StateDuration | null;
+/** «Длится»: дни — `state_days`, день программы — `program_day`, часы — `in_state`. Правится тот же выход; `null` — выход убирается. */
+export declare function setDuration(flow: AgentFlow, stateId: string, value: {
+    amount: number;
+    unit: DurationUnit;
+} | null): AgentFlow;
+export type NudgesMode = "inherit" | "own" | "off";
+export declare function nudgesMode(state: FlowState): NudgesMode;
+/** Касания ноды: как у сценария (поля нет), свои (образец — общие или 15 мин · 1 ч · 4 ч), выкл. */
+export declare function setStateNudges(flow: AgentFlow, stateId: string, mode: NudgesMode): AgentFlow;
+/** Своё расписание касаний ноды: пустые части убираются, срок в днях остаётся. */
+export declare function updateStateNudges(flow: AgentFlow, stateId: string, nudges: FlowNudges): AgentFlow;
+/** Сколько дней действуют свои касания ноды, считая день входа; `null` — всё время в ноде. */
+export declare function setStateNudgesDays(flow: AgentFlow, stateId: string, days: number | null): AgentFlow;
+/** Срок своих касаний ноды в днях; всё время в ноде или касания не свои — `null`. */
+export declare function stateNudgesDays(state: FlowState): number | null;
+/** Касания по умолчанию в «Днях и времени»; `null` — без общих касаний. */
+export declare function updateScheduleNudges(flow: AgentFlow, nudges: FlowNudges | null): AgentFlow;
+/** «15 мин», «4 ч», «3 дн.». */
+export declare function durationText(duration: FlowDuration, labels: FlowEditorLabels): string;
+/** Подпись «Длится» и касаний на карточке ноды: «1 день · касания 15 мин · 1 ч · 4 ч». Ничего своего — пусто. */
+export declare function stateTimingText(flow: AgentFlow, state: FlowState, labels: FlowEditorLabels): string;

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

@@ -0,0 +1,18 @@
+import { type AgentFlow, type FlowCatalog, type FlowCatalogField, type FlowSideTask } from "../../format/flow-format.js";
+import type { FieldList } from "./editor-model.js";
+export declare function addSideTask(flow: AgentFlow, text: string): {
+    flow: AgentFlow;
+    sideTaskId: string;
+};
+export type SideTaskPatch = {
+    [K in keyof FlowSideTask]?: FlowSideTask[K] | undefined;
+};
+/** Правка задачи: пустые «когда» и «поле» убираются, попыток — хотя бы одна. */
+export declare function updateSideTask(flow: AgentFlow, sideTaskId: string, patch: SideTaskPatch): AgentFlow;
+export declare function removeSideTask(flow: AgentFlow, sideTaskId: string): AgentFlow;
+/** Поля словаря приложения, которых ещё нет ни в карточке, ни в заметках. */
+export declare function catalogFieldsToAdd(flow: AgentFlow, catalog: FlowCatalog): FlowCatalogField[];
+/** Поле словаря приложения в карточку или заметки: id, название, тип и варианты — как у приложения. Уже есть — без правок. */
+export declare function addCatalogField(flow: AgentFlow, list: FieldList, field: FlowCatalogField): AgentFlow;
+/** Поле, по которому задача решена. Поле из словаря приложения, которого нет в сценарии, попадает в карточку. */
+export declare function setSideTaskField(flow: AgentFlow, sideTaskId: string, fieldId: string | null, catalog: FlowCatalog): AgentFlow;

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

@@ -0,0 +1,120 @@
+import type { AgentFlow, FlowCatalog, FlowIssue, FlowPoint } from "../../format/flow-format.js";
+import type { StateMap } from "../../engine/migrate-run.js";
+import type { ChatsInState } from "../../store/flow-store.js";
+import type { FlowEditorMode, FlowIssueCount } from "../flow-editor-skin.js";
+import { type FlowAppChecks, type FlowAppIssue } from "../../check/app-checks.js";
+import { type ExitOwner } from "./editor-model.js";
+import { type Simulation } from "./flow-simulation.js";
+/** Что открыто в панели справа. */
+export type FlowSelection = {
+    kind: "overview";
+    sideTaskId?: string;
+} | {
+    kind: "state";
+    stateId: string;
+    exitId?: string;
+} | {
+    kind: "any";
+    exitId?: string;
+} | {
+    kind: "card";
+};
+export type FlowDialog = "json" | "migrate" | null;
+/**
+ * Перевод идущих чатов на текущую версию. Данные и действие даёт приложение — редактор не знает, где сервер:
+ * `chatsByState` — чаты на прежних версиях (`flow.chatsByState`), `migrate` — перевод с картой удалённых состояний
+ * (`flow.migrateChats`).
+ */
+export interface FlowMigration {
+    chatsByState(): Promise<ChatsInState[]>;
+    migrate(map: StateMap): Promise<{
+        moved: number;
+    }>;
+    /** Название состояния прежней версии; нет — берём из текущей или показываем id. */
+    stateTitle?(versionId: string, stateId: string): string | undefined;
+}
+/**
+ * Ответ `onSave`. Ничего (`void`) и `{ ok: true }` — сохранено. `{ ok: false, issues }` — приложение отказало без
+ * исключения: шапка не пишет «Сохранено», `issues` встают у нод и выходов, как находки «Проверить граф».
+ */
+export type FlowSaveResult = void | {
+    ok: true;
+} | {
+    ok: false;
+    issues?: ReadonlyArray<Pick<FlowAppIssue, "path" | "message">>;
+};
+export interface UseFlowEditorOptions {
+    value: AgentFlow;
+    onChange(flow: AgentFlow): void;
+    /** Сохранить сценарий. Отказ — `{ ok: false, issues }` или исключение (оно не уходит в консоль необработанным). */
+    onSave?(flow: AgentFlow): FlowSaveResult | Promise<FlowSaveResult>;
+    /**
+     * Только просмотр: доску нельзя менять (двигать, соединять, удалять, править панели), нельзя сохранять и загружать
+     * JSON. Смотреть, проверять граф, прогонять и открывать JSON можно. Нужно, пока сценарий правит внешний агент.
+     */
+    readOnly?: boolean;
+    /** Что объявило приложение: инструменты, события и кнопки, виджеты. */
+    catalog: FlowCatalog;
+    migration?: FlowMigration;
+    /** Пояс человека для таймеров «время суток» в прогоне; по умолчанию — пояс браузера. */
+    timeZone?: string;
+    now?(): number;
+    /**
+     * Свои проверки приложения в «Проверить сценарий»: `(flow) => [{ path: "states[2]", message }]`. Находки идут после
+     * встроенных, клик ведёт на место. Те же проверки приложение передаёт в `checkFlow(flow, catalog, { checks })`.
+     */
+    checks?: FlowAppChecks;
+}
+export interface FlowMigrateRow extends ChatsInState {
+    stateTitle: string;
+    removed: boolean;
+    target: string | null;
+}
+export interface FlowMigrateController {
+    rows: FlowMigrateRow[];
+    busy: boolean;
+    failed: boolean;
+    moved: number | null;
+    canMigrate: boolean;
+    open(): void;
+    setTarget(stateId: string, target: string): void;
+    run(): Promise<void>;
+}
+/** Логика редактора сценария: правки, выбор, проверка, прогон, JSON, сохранение, перевод чатов. Скин только рисует. */
+export declare function useFlowEditor(options: UseFlowEditorOptions): {
+    flow: AgentFlow;
+    catalog: FlowCatalog;
+    issues: FlowIssue[];
+    issueCount: FlowIssueCount;
+    selection: FlowSelection;
+    select: (next: FlowSelection) => void;
+    mode: FlowEditorMode;
+    setMode: (next: FlowEditorMode) => void;
+    goToIssue: (issue: FlowIssue) => void;
+    edit: (change: (flow: AgentFlow) => AgentFlow) => void;
+    addState: (at?: FlowPoint) => string;
+    connect: (owner: ExitOwner, exitId: string, to: string) => void;
+    connectToNewState: (owner: ExitOwner, exitId: string | null, at: FlowPoint) => void;
+    removeState: (stateId: string) => void;
+    simulation: Simulation | null;
+    simulate: {
+        choose: (exitId: string) => void;
+        nothing: () => void;
+        back: () => void;
+        restart: () => void;
+        setKnown: (fieldId: string, text: string) => void;
+    };
+    dialog: FlowDialog;
+    openJson: () => void;
+    closeDialog: () => void;
+    json: string;
+    jsonErrors: string[];
+    loadJson: (text: string) => boolean;
+    save: () => Promise<void>;
+    saving: boolean;
+    saveFailed: boolean;
+    dirty: boolean;
+    readOnly: boolean;
+    migrate: FlowMigrateController | null;
+};
+export type FlowEditorController = ReturnType<typeof useFlowEditor>;