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

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

@@ -0,0 +1,453 @@
+import type { ComponentType, CSSProperties, ReactNode } from "react";
+import type { ClientCardField, FlowAfterEnd, FlowCondition, FlowConditionType, FlowDataOp, FlowField, FlowIssue, FlowNudges, FlowSchedule, FlowSideTask } from "../format/flow-format.js";
+import type { DurationUnit, NudgesMode, SchedulePatch } from "./editor/schedule-model.js";
+import type { SideTaskPatch } from "./editor/side-task-model.js";
+export type { DurationUnit, NudgesMode, SchedulePatch, SideTaskPatch };
+/** Вид стрелки: по виду условия или «назад». */
+export type FlowEdgeKind = FlowConditionType | "return";
+/** Что открыто: правка, проверка графа, прогон. */
+export type FlowEditorMode = "edit" | "check" | "run";
+/** Сколько у места ошибок и замечаний проверки. */
+export interface FlowIssueCount {
+    errors: number;
+    warnings: number;
+}
+/** Строка условия на карточке состояния. */
+export interface FlowExitRowView {
+    exitId: string;
+    kind: FlowEdgeKind;
+    /** Готовая подпись условия: «Понятны тема курса и продажи», «Тишина человека 3 ч». */
+    text: string;
+    /** Название цели; `null` — цель не выбрана. «Назад» — `kind: "return"`. */
+    target: string | null;
+    issues: FlowIssueCount;
+}
+/** Где узел в прогоне. */
+export type FlowRunMark = "current" | "visited" | null;
+export interface FlowStateNodeProps {
+    stateId: string;
+    title: string;
+    /** Первая строка инструкции. */
+    goal: string;
+    exits: FlowExitRowView[];
+    tags: string[];
+    start: boolean;
+    /** Без условий выхода — конец сценария. */
+    final: boolean;
+    noSideQuestions: boolean;
+    /** «Длится» и свои касания одной строкой: «1 день · касания 15 мин · 1 ч»; пусто — нечего показать. */
+    timing: string;
+    selected: boolean;
+    /** Приглушить: в прогоне или при выборе стрелки узел не участвует. */
+    dimmed: boolean;
+    run: FlowRunMark;
+    issues: FlowIssueCount;
+    /** Ручка входа доски: поставить на край карточки. */
+    renderInputHandle(): ReactNode;
+    /** Ручка выхода доски для строки условия. */
+    renderExitHandle(exitId: string): ReactNode;
+    onSelect(): void;
+}
+/** Узел «Из любого состояния»: общие переходы. */
+export interface FlowAnyStateNodeProps {
+    /** Названия состояний-исключений. */
+    except: string[];
+    exits: FlowExitRowView[];
+    selected: boolean;
+    dimmed: boolean;
+    issues: FlowIssueCount;
+    renderExitHandle(exitId: string): ReactNode;
+    onSelect(): void;
+}
+export interface FlowEdgeProps {
+    edgeId: string;
+    kind: FlowEdgeKind;
+    /** Путь SVG (`d`), посчитан доской. */
+    path: string;
+    /** Где поставить подпись, если скин её рисует. */
+    labelX: number;
+    labelY: number;
+    label: string;
+    selected: boolean;
+    dimmed: boolean;
+    /** Пройдена в прогоне. */
+    traversed: boolean;
+    onSelect(): void;
+}
+export interface FlowLegendProps {
+    kinds: FlowEdgeKind[];
+}
+export interface FlowZoomControlsProps {
+    /** 1 — как есть. */
+    zoom: number;
+    onZoomIn(): void;
+    onZoomOut(): void;
+    onFit(): void;
+}
+export interface FlowHeaderProps {
+    name: string;
+    onRename(name: string): void;
+    mode: FlowEditorMode;
+    onModeChange(mode: FlowEditorMode): void;
+    issues: FlowIssueCount;
+    onAddState(): void;
+    onOpenCard(): void;
+    onOpenJson(): void;
+    /** Есть, если приложение передало `onSave`. */
+    onSave?(): void;
+    saving: boolean;
+    dirty: boolean;
+    /** Приложение отказало в сохранении (без исключения или с ним): вместо «Сохранено» показать отказ. */
+    saveFailed?: boolean;
+    /** Только просмотр: показать плашку, не давать добавлять состояния и переименовывать. */
+    readOnly?: boolean;
+    /** Есть, если приложение подключило перевод чатов и тестовый чат. */
+    onOpenMigrate?(): void;
+    onOpenTestChat?(): void;
+    /** Узкая шапка: одна строка кнопок, без логотипа и названия сценария (приложение показывает своё). */
+    compact?: boolean;
+    /** Кнопка «На весь экран» / «Выйти»; нет — кнопки нет. */
+    fullscreen?: {
+        active: boolean;
+        onToggle(): void;
+    };
+}
+/** Строка списка в обзоре и панелях: состояние, на которое можно перейти. */
+export interface FlowStateLinkView {
+    stateId: string;
+    title: string;
+    start: boolean;
+    final: boolean;
+    onSelect(): void;
+}
+export interface FlowOverviewPanelProps {
+    name: string;
+    /** «Общее для всех состояний». */
+    common: string;
+    onCommonChange(common: string): void;
+    counts: {
+        states: number;
+        exits: number;
+        finals: number;
+    };
+    states: FlowStateLinkView[];
+    issues: FlowIssueCount;
+    /** Разделы «Дни и время» и «Попутные задачи» (части скина ниже); нет частей — пусто. */
+    sections?: ReactNode;
+}
+/** Раздел «Дни и время» в обзоре. Редкое — в «Дополнительно». */
+export interface FlowScheduleSectionProps {
+    /** `null` — сценарий без дней. */
+    schedule: FlowSchedule | null;
+    /** Что делать с сообщением после конца разговора; поля нет — `reply`. */
+    afterEnd: FlowAfterEnd;
+    /** Куда перейти при «срок вышел». */
+    states: FlowTargetOption[];
+    /** Находки проверки по «Дням и времени». */
+    issues: FlowIssue[];
+    /** Касания по умолчанию: `FlowNudgesEditor`. */
+    nudges: ReactNode;
+    onToggle(on: boolean): void;
+    onChange(patch: SchedulePatch): void;
+    onAfterEndChange(mode: FlowAfterEnd): void;
+}
+/** Расписание касаний: ряд сроков тишины, потом время каждый день, срок «молчит — конец». */
+export interface FlowNudgesEditorProps {
+    /** `null` — касаний нет (только для общих касаний сценария). */
+    nudges: FlowNudges | null;
+    /** Можно выключить совсем: для общих касаний — да, у ноды за это отвечает режим. */
+    optional: boolean;
+    onChange(nudges: FlowNudges | null): void;
+}
+/** Раздел «Попутные задачи» в обзоре. */
+export interface FlowSideTasksSectionProps {
+    tasks: Array<FlowSideTask & {
+        issues: FlowIssue[];
+        focused: boolean;
+    }>;
+    /** Поля карточки и заметок, плюс поля приложения (`fromApp`), которых в сценарии ещё нет. */
+    fields: Array<{
+        id: string;
+        title: string;
+        fromApp: boolean;
+    }>;
+    /** Заданы «Дни и время»: есть встроенная задача «узнать город». */
+    builtInCity: boolean;
+    onAdd(): void;
+    onChange(sideTaskId: string, patch: SideTaskPatch): void;
+    onFieldChange(sideTaskId: string, fieldId: string | null): void;
+    onDelete(sideTaskId: string): void;
+}
+/** «Длится» и «Касания» в панели ноды. */
+export interface FlowStateTimingProps {
+    /** Выход-продолжительность; `null` — не ограничено. */
+    duration: {
+        amount: number;
+        unit: DurationUnit;
+        to: string | null;
+    } | null;
+    /** Дни и «до дня N программы» есть только при «Днях и времени»; иначе — часы. */
+    daysAvailable: boolean;
+    targets: FlowTargetOption[];
+    /** Находки по выходу-продолжительности. */
+    issues: FlowIssue[];
+    onDurationChange(value: {
+        amount: number;
+        unit: DurationUnit;
+    } | null): void;
+    onDurationTargetChange(to: string | null): void;
+    nudgesMode: NudgesMode;
+    onNudgesModeChange(mode: NudgesMode): void;
+    /** Свои касания: `FlowNudgesEditor`; режим не «свои» — `null`. */
+    nudges: ReactNode | null;
+    /** Свои касания действуют столько дней, считая день входа; `null` — всё время в ноде. С 0.55. */
+    nudgesDays: number | null;
+    onNudgesDaysChange(days: number | null): void;
+}
+/** Цель перехода в списке «Куда»: состояние или «назад». */
+export interface FlowTargetOption {
+    /** `id` состояния или `@return`. */
+    value: string;
+    title: string;
+}
+/** Карточка условия в панели состояния или общих переходов. */
+export interface FlowExitCardProps {
+    exitId: string;
+    when: FlowCondition;
+    to: string | null;
+    /** Поля карточки и заметок — для условия по данным. */
+    fields: FlowField[];
+    /** Какие сравнения подходят к выбранному полю. */
+    ops: FlowDataOp[];
+    /** Имена, объявленные приложением: кнопки и события, инструменты. */
+    eventNames: {
+        button: string[];
+        tool: string[];
+        app: string[];
+    };
+    /** Подписи кнопок и событий от приложения: имя → подпись. Нет подписи — показывать имя. С 0.55. */
+    eventLabels?: Readonly<Record<string, string>>;
+    targets: FlowTargetOption[];
+    issues: FlowIssue[];
+    canMoveUp: boolean;
+    canMoveDown: boolean;
+    onChange(next: {
+        when: FlowCondition;
+        to: string | null;
+    }): void;
+    onMoveUp(): void;
+    onMoveDown(): void;
+    onDelete(): void;
+}
+export interface FlowStatePanelProps {
+    stateId: string;
+    title: string;
+    instructions: string;
+    firstMessage: string | null;
+    learn: string[];
+    tools: string[];
+    tags: string[];
+    start: boolean;
+    noSideQuestions: boolean;
+    /** Из чего выбирать «Узнать» и инструменты. */
+    fields: FlowField[];
+    catalogTools: string[];
+    /** Карточки условий: скин кладёт их в раздел «Когда выходить и куда». */
+    exits: ReactNode;
+    /** «Длится» и «Касания» (`FlowStateTiming`); нет части скина — пусто. */
+    timing?: ReactNode;
+    issues: FlowIssue[];
+    onChange(patch: {
+        title?: string;
+        instructions?: string;
+        firstMessage?: string | null;
+        learn?: string[];
+        tools?: string[];
+        tags?: string[];
+        noSideQuestions?: boolean;
+    }): void;
+    onMakeStart(): void;
+    onAddExit(kind: FlowConditionType): void;
+    onDelete(): void;
+}
+export interface FlowAnyStatePanelProps {
+    except: string[];
+    states: FlowStateLinkView[];
+    onExceptChange(stateIds: string[]): void;
+    exits: ReactNode;
+    onAddExit(kind: FlowConditionType): void;
+}
+/** Поле карточки или заметки в панели «Карточка и заметки». */
+export interface FlowFieldRowProps {
+    field: FlowField | ClientCardField;
+    list: "clientCard" | "chatNotes";
+    canMoveUp: boolean;
+    canMoveDown: boolean;
+    issues: FlowIssue[];
+    onChange(patch: Partial<ClientCardField>): void;
+    onMoveUp(): void;
+    onMoveDown(): void;
+    onDelete(): void;
+}
+export interface FlowCardPanelProps {
+    /** Строки полей: `FlowFieldRow` по порядку. */
+    clientCard: ReactNode;
+    chatNotes: ReactNode;
+    empty: boolean;
+    sideQuestionEveryMessages: number;
+    onPaceChange(messages: number): void;
+    onAddField(list: "clientCard" | "chatNotes"): void;
+    /** Поля словаря приложения (`catalog.fields`), которых в сценарии ещё нет. */
+    appFields: Array<{
+        id: string;
+        title: string;
+    }>;
+    onAddAppField(list: "clientCard" | "chatNotes", fieldId: string): void;
+}
+export interface FlowCheckPanelProps {
+    issues: Array<FlowIssue & {
+        onGo(): void;
+    }>;
+}
+/** Выбор «что произошло» в прогоне: условие текущего состояния или общее. */
+export interface FlowRunChoiceView {
+    exitId: string;
+    kind: FlowEdgeKind;
+    text: string;
+    target: string | null;
+    onChoose(): void;
+}
+export interface FlowRunPanelProps {
+    current: {
+        stateId: string;
+        title: string;
+        goal: string;
+    };
+    choices: FlowRunChoiceView[];
+    onNothing(): void;
+    /** Что агент знает: поле, значение строкой или `null`, устарело ли. */
+    known: Array<{
+        fieldId: string;
+        name: string;
+        value: string | null;
+        stale: boolean;
+        onChange(value: string): void;
+    }>;
+    /** Название поля, о котором агент спросит между делом; `null` — ни о чём. */
+    nextQuestion: string | null;
+    path: Array<{
+        stateId: string;
+        title: string;
+        via: string | null;
+    }>;
+    canGoBack: boolean;
+    onBack(): void;
+    onRestart(): void;
+    onFinish(): void;
+}
+export interface FlowJsonDialogProps {
+    json: string;
+    /** Ошибки разбора загруженного JSON, готовыми строками. */
+    errors: string[];
+    onCopy(): void;
+    onDownload(): void;
+    onLoad(text: string): void;
+    onClose(): void;
+    /** Только просмотр: JSON можно смотреть, копировать и скачивать, но не загружать. */
+    readOnly?: boolean;
+}
+export interface FlowMigrateDialogProps {
+    rows: Array<{
+        versionId: string;
+        stateId: string;
+        stateTitle: string;
+        chats: number;
+        /** Состояния нет в новой версии: нужна цель. */
+        removed: boolean;
+        target: string | null;
+        onTargetChange(stateId: string): void;
+    }>;
+    targets: FlowTargetOption[];
+    busy: boolean;
+    failed: boolean;
+    /** Сколько перевели; `null` — ещё не переводили. */
+    moved: number | null;
+    canMigrate: boolean;
+    onMigrate(): void;
+    onClose(): void;
+}
+export interface FlowTestChatFrameProps {
+    stateTitle: string;
+    /** Сдвиг часов чата, готовой строкой («+1 ч 20 мин»). */
+    clock: string;
+    /** Варианты перемотки: подпись и сколько мс. */
+    advanceSteps: Array<{
+        label: string;
+        ms: number;
+    }>;
+    onAdvance(ms: number): void;
+    /** «День 2 из 3 · 14:20»; `null` — у сценария нет «Дней и времени» или ходов ещё не было. */
+    day: string | null;
+    /** К началу следующего дня сценария; нет — кнопки нет (нет «Дней и времени» или приложение не дало перемотку). */
+    onNextDay?(): void;
+    /** Идёт запуск чата или перемотка: кнопки перемотки ждут. */
+    busy: boolean;
+    /** Чат не открылся или часы не перемотались. */
+    failed: boolean;
+    onReset(): void;
+    onClose(): void;
+    /** Сам чат (экран чата приложения); `null` — чат ещё создаётся. */
+    children: ReactNode;
+}
+/** Раскладка редактора: шапка, доска и панель справа (`null` — панель закрыта). */
+export interface FlowEditorFrameProps {
+    header: ReactNode;
+    board: ReactNode;
+    panel: ReactNode | null;
+    /** Окно поверх: JSON, перевод чатов, тестовый чат. */
+    dialog: ReactNode | null;
+    /** Класс и стиль корня, которые приложение передало в `FlowEditor`. Корень сам занимает высоту родителя, не меньше разумной. */
+    className?: string;
+    style?: CSSProperties;
+    /** Шапка в одну узкую строку. */
+    compact?: boolean;
+}
+/** Маленькая кнопка на доске или в шапке: свернуть и развернуть легенду, мини-карту, панель «Сценарий». */
+export interface FlowBoardToggleProps {
+    kind: "legend" | "minimap" | "inspector";
+    /** Что сделает нажатие: «Показать мини-карту», «Скрыть панель «Сценарий»». */
+    label: string;
+    /** Показывается сейчас то, чем кнопка управляет. */
+    expanded: boolean;
+    /** С подписью рядом со значком (легенда), без неё — только значок. */
+    showText?: boolean;
+    onClick(): void;
+}
+/** Договор скина редактора сценария, версия 1. */
+export interface FlowEditorSkin {
+    FlowEditorFrame: ComponentType<FlowEditorFrameProps>;
+    FlowHeader: ComponentType<FlowHeaderProps>;
+    FlowStateNode: ComponentType<FlowStateNodeProps>;
+    FlowAnyStateNode: ComponentType<FlowAnyStateNodeProps>;
+    FlowEdge: ComponentType<FlowEdgeProps>;
+    FlowLegend: ComponentType<FlowLegendProps>;
+    FlowZoomControls: ComponentType<FlowZoomControlsProps>;
+    FlowOverviewPanel: ComponentType<FlowOverviewPanelProps>;
+    FlowStatePanel: ComponentType<FlowStatePanelProps>;
+    FlowAnyStatePanel: ComponentType<FlowAnyStatePanelProps>;
+    FlowExitCard: ComponentType<FlowExitCardProps>;
+    FlowCardPanel: ComponentType<FlowCardPanelProps>;
+    FlowFieldRow: ComponentType<FlowFieldRowProps>;
+    FlowCheckPanel: ComponentType<FlowCheckPanelProps>;
+    FlowRunPanel: ComponentType<FlowRunPanelProps>;
+    FlowJsonDialog: ComponentType<FlowJsonDialogProps>;
+    FlowMigrateDialog: ComponentType<FlowMigrateDialogProps>;
+    FlowTestChatFrame: ComponentType<FlowTestChatFrameProps>;
+    /** Кнопки места на доске. Нет — доска рисует простые кнопки на токенах `--flow-board-*`. */
+    FlowBoardToggle?: ComponentType<FlowBoardToggleProps>;
+    /** Части формата v2 (сценарии 0.49). Нет — разделов нет, остальное работает. */
+    FlowScheduleSection?: ComponentType<FlowScheduleSectionProps>;
+    FlowSideTasksSection?: ComponentType<FlowSideTasksSectionProps>;
+    FlowStateTiming?: ComponentType<FlowStateTimingProps>;
+    FlowNudgesEditor?: ComponentType<FlowNudgesEditorProps>;
+}

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

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import { type FlowLabels } from "../labels/index.js";
+/** Надписи экранов сценария; по умолчанию русские (`russianFlowLabels`). */
+export declare function FlowLabelsProvider({ labels, children }: {
+    labels: FlowLabels;
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<FlowLabels>>;
+export declare function useFlowLabels(): FlowLabels;

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

@@ -0,0 +1,6 @@
+export { FlowLabelsProvider, useFlowLabels } from "./flow-labels.js";
+export type * from "./flow-editor-skin.js";
+export type * from "./client-card-skin.js";
+export * from "./editor/index.js";
+export * from "./client-card/index.js";
+export * from "./test-chat/index.js";

package/dist/types/react/test-chat/flow-test-chat.d.ts

@@ -0,0 +1,22 @@
+import type { FlowDayInfo } from "../../engine/flow-days.js";
+import { type FlowTestChatLabels } from "../../labels/test-chat.js";
+import { type FlowEditorProps } from "../editor/flow-editor.js";
+import { type FlowTestChatConnection } from "./use-flow-test-chat.js";
+/** Варианты перемотки по умолчанию: 20 минут, 3 часа, сутки. */
+export declare const DEFAULT_ADVANCE_STEPS: readonly number[];
+/** Длительность словами: «1 д 3 ч 20 мин». */
+export declare function formatDuration(ms: number, units: FlowTestChatLabels["units"]): string;
+/** Сдвиг часов тестового чата готовой строкой: «как сейчас», «+3 ч 20 мин». */
+export declare function formatClockOffset(ms: number, labels?: FlowTestChatLabels): string;
+/** Строка дня тестового чата: «День 2 из 3 · 14:20» по часам чата в поясе человека; дней нет — `null`. */
+export declare function formatDayLine(day: FlowDayInfo | null | undefined, at: number, timeZone: string, labels?: FlowTestChatLabels): string | null;
+export interface FlowTestChatProps extends FlowEditorProps {
+    testChat: FlowTestChatConnection;
+    /** Варианты перемотки, мс. По умолчанию `DEFAULT_ADVANCE_STEPS`. */
+    advanceSteps?: readonly number[];
+}
+/**
+ * Редактор сценария с тестовым чатом: автор пишет агенту рядом с доской, видит текущее состояние и перематывает часы
+ * чата, чтобы проверить таймеры без ожидания. Сервер и экран чата даёт приложение (`testChat`).
+ */
+export declare function FlowTestChat({ testChat, advanceSteps, skin, ...editor }: FlowTestChatProps): import("react").JSX.Element;

package/dist/types/react/test-chat/index.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_ADVANCE_STEPS, FlowTestChat, formatClockOffset, formatDayLine, formatDuration, type FlowTestChatProps } from "./flow-test-chat.js";
+export { useFlowTestChat, type FlowTestChatConnection, type FlowTestChatController } from "./use-flow-test-chat.js";

package/dist/types/react/test-chat/use-flow-test-chat.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from "react";
+import type { FlowDayInfo } from "../../engine/flow-days.js";
+import type { FlowRun } from "../../engine/flow-run.js";
+import type { AgentFlow } from "../../format/flow-format.js";
+/** Что тестовому чату нужно от приложения: сервер и экран чата. Редактор не знает, где сервер. */
+export interface FlowTestChatConnection {
+    /** Новый тестовый чат по сценарию из редактора: сервер создаёт его с `flowTestChatData()`. */
+    start(flow: AgentFlow): Promise<{
+        chatId: string;
+    }>;
+    /** Промотать часы чата: на сервере `flow.advanceTestClock`. */
+    advance(chatId: string, ms: number): Promise<{
+        timeOffset: number;
+    }>;
+    /**
+     * Промотать часы к началу следующего дня сценария: на сервере `flow.advanceTestClock({ chatId, to: "next_day_start" })`.
+     * Нет — кнопки «К началу следующего дня» нет.
+     */
+    advanceToNextDay?(chatId: string): Promise<{
+        timeOffset: number;
+    }>;
+    /** Место чата: на сервере `flow.readRun`. В браузер посетителя место не уходит, доска читает его отдельно. */
+    readRun(chatId: string): Promise<(Pick<FlowRun, "state" | "path"> & {
+        day?: FlowDayInfo;
+    }) | null>;
+    /** Экран чата приложения: `<AgentChat api=… chatId={chatId} skin=… />`. */
+    renderChat(chatId: string): ReactNode;
+}
+export interface FlowTestChatController {
+    opened: boolean;
+    chatId: string | null;
+    /** Сдвиг часов чата, мс. */
+    timeOffset: number;
+    busy: boolean;
+    failed: boolean;
+    /** Где чат на доске; пока ходов нет — старт сценария. */
+    stateId: string | null;
+    /** Пройденные состояния, без текущего. */
+    visited: ReadonlySet<string>;
+    /** День сценария чата; `null` — у сценария нет «Дней и времени» или ходов ещё не было. */
+    day: FlowDayInfo | null;
+    open(): void;
+    close(): void;
+    reset(): void;
+    advance(ms: number): void;
+    /** К началу следующего дня сценария; `null` — приложение не дало `advanceToNextDay`. */
+    nextDay: (() => void) | null;
+}
+/** Логика тестового чата редактора: открыть, перемотать, начать заново, подсветка состояния. */
+export declare function useFlowTestChat(connection: FlowTestChatConnection, flow: AgentFlow): FlowTestChatController;

package/dist/types/react.d.ts

@@ -0,0 +1,3 @@
+export * from "./react/index.js";
+export { englishFlowLabels, russianFlowLabels } from "./labels/index.js";
+export type { ClientCardLabels, FlowEditorLabels, FlowLabels, FlowMigrateLabels, FlowTestChatLabels } from "./labels/index.js";

package/dist/types/runtime/admit.d.ts

@@ -0,0 +1,15 @@
+import type { FlowAdmitDecision, FlowAdmitInput, FlowPort } from "./flow-types.js";
+import { type FlowRuntime } from "./flow-events.js";
+export type FlowAdmit = (input: FlowAdmitInput) => Promise<FlowAdmitDecision>;
+/**
+ * Решение для сообщения, которое только пришло: оно ещё не посчитано в `run.dayCounts` (счёт ведёт ход, а сообщение
+ * без хода — «промолчать» — не считается). Поэтому оно `счёт + 1`-е за день: на `hardAt`-м — готовая фраза один раз,
+ * дальше — молчание до начала следующего дня, а в его начале — ответ на накопленное. Без рамок дня, паузы и конца разговора — `answer`, как в 0.48.
+ */
+export declare function createFlowAdmit({ runtime, port }: {
+    runtime: FlowRuntime;
+    port: (chat: {
+        ownerId: string;
+        chatId: string;
+    }) => Promise<FlowPort>;
+}): FlowAdmit;

package/dist/types/runtime/agent-flow.d.ts

@@ -0,0 +1,20 @@
+import type { AgentFlowHandle, AgentFlowOptions, ChatMigrator, ClientCardTools, FirstMessageRules, FlowJudge, FlowTimers } from "./flow-types.js";
+/** Модули других частей сценария; тесты подменяют их подделками. Нет — создаются по настройкам при первом обращении. */
+export interface FlowModules {
+    judge?: FlowJudge;
+    timers?: FlowTimers;
+    firstMessages?: FirstMessageRules | null;
+    clientCard?: ClientCardTools;
+    migrator?: ChatMigrator;
+}
+export interface BuiltAgentFlow extends AgentFlowHandle {
+    /** Дождаться фоновой работы: судья после хода, доставка точного первого текста, `onTransition`. Для тестов и остановки. */
+    settled(): Promise<void>;
+}
+/** Сборка сценария с подменяемыми модулями. Приложению — `createAgentFlow`. */
+export declare function buildAgentFlow(options: AgentFlowOptions, modules?: FlowModules): BuiltAgentFlow;
+/**
+ * Сценарий поведения агента для службы чата. Подключение:
+ * `const { service } = createChatServer(flow.withChat({ agent, chatInstructions, afterTurn, … }))`, затем `flow.attach(service)`.
+ */
+export declare function createAgentFlow(options: AgentFlowOptions): AgentFlowHandle;

package/dist/types/runtime/client-card.d.ts

@@ -0,0 +1,9 @@
+import type { FlowStore } from "../store/flow-store.js";
+import type { ClientCardStore, ClientCardTools } from "./flow-types.js";
+/**
+ * Карточка клиента: чтение, запись агентом, «стереть поле» и «стереть всё». Есть `adapter` — всё лежит в хранилище
+ * приложения (читается, пишется и стирается там, таблица модуля не нужна). Нет — таблица модуля, как в 0.48.
+ */
+export declare function createClientCard(store: FlowStore, now: () => Date, adapter?: ClientCardStore, logError?: (message: string) => void, options?: {
+    facts?: boolean;
+}): ClientCardTools;

package/dist/types/runtime/client-facts.d.ts

@@ -0,0 +1,22 @@
+import type { ClientFact, FlowStore } from "../store/flow-store.js";
+import type { ClientCardStore, ClientFactStore } from "./flow-types.js";
+/** Факт в таблице карточки модуля — запись с `fieldId` = `fact:<id>`; приложение не должно называть так свои поля. */
+export declare const FACT_PREFIX = "fact:";
+export declare const MAX_FACTS = 30;
+export declare const MAX_FACT_LENGTH = 200;
+/** Тот же факт (с точностью до регистра и пробелов) — тот же id: `f` и восемь шестнадцатеричных цифр. */
+export declare function factId(text: string): string;
+export declare const sameFact: (left: string, right: string) => boolean;
+export declare const isFactEntry: (fieldId: string) => boolean;
+/** Факты по времени записи, раньше — выше: начало блока для модели не меняется, пока не пишут новое. */
+export declare const byWriteOrder: (left: ClientFact, right: ClientFact) => number;
+/** Факты человека: у приложения (`clientCard.facts`) или в таблице модуля. */
+export declare function clientFactStore(store: FlowStore, adapter?: ClientCardStore): ClientFactStore;
+/** Факт как запись карточки: так его видят `readClientCard` и экран («Что агент знает о вас»). */
+export declare const factEntry: (fact: ClientFact) => {
+    fieldId: string;
+    value: string;
+    updatedAt: string;
+    chatId: string;
+    flowId: string;
+};

package/dist/types/runtime/close-day-tool.d.ts

@@ -0,0 +1,3 @@
+import type { FlowExtraTool } from "./extra-tool.js";
+export declare const FLOW_CLOSE_DAY_TOOL = "flow_close_day";
+export declare const closeDayTool: FlowExtraTool;

package/dist/types/runtime/decisions-client.d.ts

@@ -0,0 +1,33 @@
+export interface DecisionSettings {
+    apiKey: string;
+    /** Адрес OpenRouter приложения, обычно `…/api/v1`; прокси работает так же. */
+    baseUrl: string;
+    /** Свои заголовки приложения (например, `X-Proxy-Token` прокси). Ключ и тип содержимого они не подменяют. */
+    headers?: Record<string, string>;
+    /** Для тестов. */
+    fetch?: typeof fetch;
+}
+export interface DecisionQuestion {
+    /** Ключ ответа: `id` условия сценария. */
+    id: string;
+    instructions: string;
+}
+export interface DecisionRequest {
+    model: string;
+    /** Что оценивать: любой JSON. */
+    state: unknown;
+    questions: DecisionQuestion[];
+    signal?: AbortSignal;
+}
+export interface DecisionResponse {
+    /** Вероятность «да» (`noul`, 0…1) по `id` вопроса. Вопроса без числового ответа здесь нет: цена всё равно списана. */
+    answers: Record<string, number>;
+    /** Цена вызова, доллары (`usage.cost`). */
+    cost: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+/** Адрес `/api/alpha/decisions` рядом с `…/api/v1` приложения: прокси с путём работает так же. */
+export declare function decisionsUrl(baseUrl: string): string;
+/** Клиент OpenRouter `/api/alpha/decisions`: вопросы `noul`, на каждый — вероятность «да». */
+export declare function requestDecision(settings: DecisionSettings, request: DecisionRequest): Promise<DecisionResponse>;