@ykurilov/agent-chat-flows 0.63.2 → 0.64.0

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

@@ -5,3 +5,4 @@ export { migrateFlow } from "./migrate-flow.js";
 export { catalogEventLabel, catalogEventNames } from "./catalog-events.js";
 export { compactFlow } from "./compact-flow.js";
 export { flowJsonSchema } from "./flow-json-schema.js";
+export { parseDuration } from "./parse-duration.js";

package/dist/types/format/parse-duration.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Длительность словами в мс: «15 мин» → 900 000, «1 ч 30 мин», «2 дня», «1h 30m», «2 days». Каждое число — со своей
+ * единицей; непонятное, пустое или ноль — `undefined`.
+ */
+export declare function parseDuration(text: string): number | undefined;

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

@@ -19,6 +19,14 @@ export interface FlowTestChatLabels {
     failed: string;
     /** Перемотка к началу следующего дня сценария. */
     nextDay: string;
+    /** Перемотка к моменту, когда сценарий сам напишет первым. */
+    nextFirstMessage: string;
+    /** Впереди сценарий сам ничего не напишет: перематывать к напоминанию не к чему. */
+    nothingScheduled: string;
+    /** Поле «своё время»: подпись, пример и подсказка на непонятное. */
+    customTime: string;
+    customTimePlaceholder: string;
+    customTimeInvalid: string;
     /** «День 2 из 3», «День 2». */
     day: (day: number, totalDays?: number) => string;
     /** Вечер позднего старта: первый день ещё не начался. */

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

@@ -390,6 +390,12 @@ export interface FlowTestChatFrameProps {
     day: string | null;
     /** К началу следующего дня сценария; нет — кнопки нет (нет «Дней и времени» или приложение не дало перемотку). */
     onNextDay?(): void;
+    /** К моменту, когда сценарий сам напишет первым; нет — кнопки нет (приложение не дало перемотку). */
+    onNextFirstMessage?(): void;
+    /** Последняя перемотка к напоминанию не нашла, к чему перематывать: впереди сценарий сам ничего не напишет. */
+    nothingScheduled?: boolean;
+    /** Поле «своё время»: текст вроде «1 ч 30 мин»; `false` — не понял, перемотки не было. Нет — поля нет. */
+    onAdvanceText?(text: string): boolean;
     /** Идёт запуск чата или перемотка: кнопки перемотки ждут. */
     busy: boolean;
     /** Чат не открылся или часы не перемотались. */

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

@@ -19,6 +19,14 @@ export interface FlowTestChatConnection {
     advanceToNextDay?(chatId: string): Promise<{
         timeOffset: number;
     }>;
+    /**
+     * Промотать часы ровно к моменту, когда сценарий сам напишет первым: на сервере
+     * `flow.advanceTestClock({ chatId, to: "next_first_message" })`. Впереди ничего — ошибка с `code: "nothing_scheduled"`
+     * (у `FlowTestClockError`; через сеть передайте код). Нет — кнопки «К следующему напоминанию» нет.
+     */
+    advanceToNextFirstMessage?(chatId: string): Promise<{
+        timeOffset: number;
+    }>;
     /** Место чата: на сервере `flow.readRun`. В браузер посетителя место не уходит, доска читает его отдельно. */
     readRun(chatId: string): Promise<(Pick<FlowRun, "state" | "path"> & {
         day?: FlowDayInfo;
@@ -45,6 +53,10 @@ export interface FlowTestChatController {
     advance(ms: number): void;
     /** К началу следующего дня сценария; `null` — приложение не дало `advanceToNextDay`. */
     nextDay: (() => void) | null;
+    /** К следующему сообщению сценария; `null` — приложение не дало `advanceToNextFirstMessage`. */
+    nextFirstMessage: (() => void) | null;
+    /** Последняя перемотка к напоминанию: впереди сценарий сам ничего не напишет. */
+    nothingScheduled: boolean;
 }
 /** Логика тестового чата редактора: открыть, перемотать, начать заново, подсветка состояния. */
 export declare function useFlowTestChat(connection: FlowTestChatConnection, flow: AgentFlow): FlowTestChatController;

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

@@ -202,6 +202,8 @@ export interface FlowTimers {
         branchHead: string | null;
         failedAt?: number;
     }): Promise<void>;
+    /** Слушать, что сработало по таймеру чата (ход «пишет первым», «срок вышел», «не завершил»); возврат — отписка. */
+    watch?(chatId: string, onFired: (fired: FlowTestClockReason) => void): () => void;
 }
 export interface FirstMessageRules {
     /** Можно ли написать первым сейчас; нет — когда повторить (мс) или `null`. */
@@ -372,7 +374,10 @@ export type FlowAdmitDecision = {
  | {
     kind: "paused";
 };
-/** Перемотка тестового чата: на `ms` или до начала следующего дня сценария. */
+/**
+ * Перемотка тестового чата: на `ms`, до начала следующего дня сценария или ровно к моменту, когда сценарий напишет первым
+ * (`next_first_message`, с 0.64).
+ */
 export type FlowTestClockInput = {
     ownerId: string;
     chatId: string;
@@ -380,9 +385,25 @@ export type FlowTestClockInput = {
     ms: number;
     to?: undefined;
 } | {
-    to: "next_day_start";
+    to: "next_day_start" | "next_first_message";
     ms?: undefined;
 });
+/**
+ * Что случилось в момент, куда перемотал `next_first_message`: вид — первая причина хода «пишет первым» (`transition`,
+ * `morning`, `silence`…), `deadline` — «срок вышел», `give_up` — «не завершил». `stateId` — нода после срабатывания,
+ * `exitId` — выход ноды по таймеру, `reasons` — все причины хода.
+ */
+export interface FlowTestClockReason {
+    kind: FlowFirstReason["kind"] | "deadline" | "give_up";
+    stateId: string;
+    exitId?: string;
+    reasons?: FlowFirstReason[];
+}
+/** Итог перемотки тестового чата: новый сдвиг часов, мс; у `next_first_message` — что сработало. */
+export interface FlowTestClockResult {
+    timeOffset: number;
+    reason?: FlowTestClockReason;
+}
 export interface FlowAdmitInput {
     ownerId: string;
     chatId: string;
@@ -600,11 +621,11 @@ export interface AgentFlowHandle {
     /**
      * Тестовый чат редактора (создан с `flowTestChatData()`): промотать его часы вперёд на `ms` или до начала следующего
      * дня сценария (`to: "next_day_start"`, по часам человека). Наступивший таймер срабатывает сразу; ответ ждёт конца
-     * его хода. Рабочий чат — ошибка.
+     * его хода. Рабочий чат — ошибка. `to: "next_first_message"` — ровно к моменту, когда сценарий сам напишет первым
+     * (касание, утреннее, выход ноды по сроку, «срок вышел», «не завершил»), с учётом ночи и потолков; впереди ничего —
+     * `FlowTestClockError` с кодом `nothing_scheduled`, часы не тронуты.
      */
-    advanceTestClock(input: FlowTestClockInput): Promise<{
-        timeOffset: number;
-    }>;
+    advanceTestClock(input: FlowTestClockInput): Promise<FlowTestClockResult>;
     start(): void;
     stop(): Promise<void>;
     /**

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

@@ -3,7 +3,7 @@ export { FLOW_SERVICE_BLOCKS } from "./flow-service-blocks.js";
 export type * from "./flow-types.js";
 export { DEFAULT_JUDGE_MODEL, DEFAULT_JUDGE_THRESHOLD, DEFAULT_JUDGE_TIMEOUT_MS } from "./judge.js";
 export { DEFAULT_TIMER_LEASE_MS, DEFAULT_TIMER_TICK_MS } from "./flow-timers.js";
-export { flowTestChatData, testChatOffset } from "./test-clock.js";
+export { FlowTestClockError, flowTestChatData, testChatOffset } from "./test-clock.js";
 export { DEFAULT_PAUSE_STAFF_SILENCE_HOURS } from "./pause.js";
 export { FLOW_EXIT_TOOL, FLOW_EXTRA_TOOLS } from "./flow-tools.js";
 export { FLOW_TIME_ZONE_TOOL } from "./time-zone-tool.js";

package/dist/types/runtime/test-clock.d.ts

@@ -1,6 +1,6 @@
 import { type FlowRun } from "../engine/flow-run.js";
 import { type FlowRuntime } from "./flow-events.js";
-import type { FlowPort, FlowTestClockInput, FlowTimers } from "./flow-types.js";
+import type { FlowPort, FlowTestClockInput, FlowTestClockResult, FlowTimers } from "./flow-types.js";
 /** Ключ данных чата (`Chat.data`) с пометкой тестового чата и сдвигом его часов. */
 export declare const FLOW_TEST_CHAT_KEY = "flowTestChat";
 /** Данные нового тестового чата: `service.createChat(userId, { data: flowTestChatData() })`. */
@@ -9,6 +9,11 @@ export declare function flowTestChatData(): Record<string, unknown>;
 export declare function testChatOffset(data: Record<string, unknown> | undefined): number | null;
 /** Часы чата, мс: часы сервера плюс сдвиг тестового чата. */
 export declare const chatTime: (run: Pick<FlowRun, "timeOffset"> | null | undefined, serverNow: number) => number;
+/** Перемотка не удалась по понятной причине: `nothing_scheduled` — впереди сценарий сам ничего не напишет. */
+export declare class FlowTestClockError extends Error {
+    readonly code: "nothing_scheduled" | "not_reached";
+    constructor(code: "nothing_scheduled" | "not_reached", message: string);
+}
 /**
  * Промотать часы тестового чата вперёд: на `ms` или до начала следующего дня сценария (`to: "next_day_start"`). Сдвиг
  * в данные чата, ближайший таймер пересчитан по новым часам и, если наступил, срабатывает сразу (агент пишет первым по
@@ -21,6 +26,4 @@ export declare function advanceTestClock(input: {
     ownerId: string;
     chatId: string;
     clock: FlowTestClockInput;
-}): Promise<{
-    timeOffset: number;
-}>;
+}): Promise<FlowTestClockResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykurilov/agent-chat-flows",
-  "version": "0.63.2",
+  "version": "0.64.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -56,13 +56,13 @@
     "ai": "7.0.122",
     "drizzle-orm": "^0.45.3",
     "zod": "^4.6.5",
-    "@ykurilov/agent-chat-core": "0.63.2"
+    "@ykurilov/agent-chat-core": "0.64.0"
   },
   "peerDependencies": {
     "better-sqlite3": "^13.0.3",
     "pg": "^8.23.0",
     "react": "^19.3.0",
-    "@ykurilov/agent-chat-react": "^0.63.2"
+    "@ykurilov/agent-chat-react": "^0.64.0"
   },
   "peerDependenciesMeta": {
     "@ykurilov/agent-chat-react": {
@@ -90,7 +90,7 @@
     "pg": "^8.23.0",
     "react": "^19.3.0",
     "tsx": "4.23.15",
-    "@ykurilov/agent-chat-react": "0.63.2"
+    "@ykurilov/agent-chat-react": "0.64.0"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs",