@ykurilov/agent-chat-flows 0.63.2 → 0.65.0

package/dist/react.js

@@ -1,7 +1,9 @@
 import {
   FACT_PREFIX,
+  FLOW_DEADLINE_NOTICE,
+  FLOW_TIMER_NOTICE,
   fieldValueText
-} from "./chunk-KGWXTWBZ.js";
+} from "./chunk-KRZMJJKG.js";
 import {
   ANY_STATE_LAYOUT_KEY,
   DEFAULT_LATE_START_HOURS,
@@ -23,12 +25,13 @@ import {
   noteAgentAnswer,
   noteHumanMessage,
   noteSideQuestion,
+  parseDuration,
   parseFlow,
   sideQuestion,
   startRun,
   stateById,
   timerDueAt
-} from "./chunk-LT4QELAZ.js";
+} from "./chunk-7VR4YNTJ.js";
 
 // src/react/flow-labels.ts
 import { createContext, createElement, useContext } from "react";
@@ -598,6 +601,53 @@ var englishFlowMigrateLabels = {
   failed: "Could not move the chats. Try again"
 };
 
+// src/labels/notices.ts
+var withTarget = (head, condition, stateTitle) => `${head}${condition ? ` (${condition})` : ""}${stateTitle ? ` \u2192 \xAB${stateTitle}\xBB` : ""}`;
+var russianFlowNoticeLabels = {
+  wroteFirst: (reasons) => `\u0410\u0433\u0435\u043D\u0442 \u043D\u0430\u043F\u0438\u0441\u0430\u043B \u043F\u0435\u0440\u0432\u044B\u043C \u2014 ${reasons}`,
+  separator: ", ",
+  silentFor: (duration) => `\u0447\u0435\u043B\u043E\u0432\u0435\u043A \u043C\u043E\u043B\u0447\u0430\u043B ${duration}`,
+  silence: "\u043A\u0430\u0441\u0430\u043D\u0438\u0435 \u043F\u043E\u0441\u043B\u0435 \u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044F",
+  morning: "\u0443\u0442\u0440\u043E \u043D\u043E\u0432\u043E\u0433\u043E \u0434\u043D\u044F",
+  daily: (at) => `\u043A\u0430\u0441\u0430\u043D\u0438\u0435 \u043F\u043E \u0440\u0430\u0441\u043F\u0438\u0441\u0430\u043D\u0438\u044E \u0432 ${at}`,
+  nightMessages: (count) => `\u043E\u0442\u0432\u0435\u0442 \u043D\u0430 \u043D\u043E\u0447\u043D\u044B\u0435 \u0441\u043E\u043E\u0431\u0449\u0435\u043D\u0438\u044F (${count})`,
+  farewell: "\u043F\u0440\u043E\u0449\u0430\u043D\u0438\u0435: \u0441\u0440\u043E\u043A \u043F\u0440\u043E\u0433\u0440\u0430\u043C\u043C\u044B \u0432\u044B\u0448\u0435\u043B",
+  stateDeadline: (condition, stateTitle) => withTarget("\u0441\u0440\u043E\u043A \u0448\u0430\u0433\u0430 \u0432\u044B\u0448\u0435\u043B", condition, stateTitle),
+  overallDeadline: (condition, stateTitle) => withTarget("\u043E\u0431\u0449\u0438\u0439 \u0441\u0440\u043E\u043A \u0432\u044B\u0448\u0435\u043B", condition, stateTitle),
+  conditions: {
+    stateDays: (duration) => `\u0448\u0430\u0433 \u0434\u043B\u0438\u043B\u0441\u044F ${duration}`,
+    programDay: (day) => `\u043D\u0430\u0441\u0442\u0443\u043F\u0438\u043B \u0434\u0435\u043D\u044C ${day}`,
+    timeOfDay: (at) => `\u043D\u0430\u0441\u0442\u0443\u043F\u0438\u043B\u043E ${at}`,
+    silence: (duration) => `\u0442\u0438\u0448\u0438\u043D\u0430 ${duration}`,
+    inState: (duration) => `\u0432 \u0448\u0430\u0433\u0435 ${duration}`,
+    sinceStart: (duration) => `${duration} \u0441 \u043D\u0430\u0447\u0430\u043B\u0430 \u0440\u0430\u0437\u0433\u043E\u0432\u043E\u0440\u0430`
+  },
+  units: { day: "\u0434", hour: "\u0447", minute: "\u043C\u0438\u043D" },
+  lessThanMinute: "\u043C\u0435\u043D\u044C\u0448\u0435 \u043C\u0438\u043D\u0443\u0442\u044B"
+};
+var englishFlowNoticeLabels = {
+  wroteFirst: (reasons) => `The agent wrote first \u2014 ${reasons}`,
+  separator: ", ",
+  silentFor: (duration) => `the person was silent for ${duration}`,
+  silence: "a nudge after silence",
+  morning: "a new day's morning",
+  daily: (at) => `a scheduled nudge at ${at}`,
+  nightMessages: (count) => `a reply to night messages (${count})`,
+  farewell: "a farewell: the program is over",
+  stateDeadline: (condition, stateTitle) => withTarget("the step's time is up", condition, stateTitle),
+  overallDeadline: (condition, stateTitle) => withTarget("the overall time is up", condition, stateTitle),
+  conditions: {
+    stateDays: (duration) => `the step lasted ${duration}`,
+    programDay: (day) => `day ${day} began`,
+    timeOfDay: (at) => `it's ${at}`,
+    silence: (duration) => `silence for ${duration}`,
+    inState: (duration) => `${duration} in the step`,
+    sinceStart: (duration) => `${duration} since the start`
+  },
+  units: { day: "d", hour: "h", minute: "min" },
+  lessThanMinute: "less than a minute"
+};
+
 // src/labels/test-chat.ts
 var russianFlowTestChatLabels = {
   title: "\u0422\u0435\u0441\u0442\u043E\u0432\u044B\u0439 \u0447\u0430\u0442",
@@ -610,6 +660,11 @@ var russianFlowTestChatLabels = {
   close: "\u0417\u0430\u043A\u0440\u044B\u0442\u044C",
   failed: "\u041D\u0435 \u043F\u043E\u043B\u0443\u0447\u0438\u043B\u043E\u0441\u044C \u2014 \u043F\u043E\u043F\u0440\u043E\u0431\u0443\u0439\u0442\u0435 \u0435\u0449\u0451 \u0440\u0430\u0437",
   nextDay: "\u041A \u043D\u0430\u0447\u0430\u043B\u0443 \u0441\u043B\u0435\u0434\u0443\u044E\u0449\u0435\u0433\u043E \u0434\u043D\u044F",
+  nextFirstMessage: "\u041A \u0441\u043B\u0435\u0434\u0443\u044E\u0449\u0435\u043C\u0443 \u043D\u0430\u043F\u043E\u043C\u0438\u043D\u0430\u043D\u0438\u044E",
+  nothingScheduled: "\u0412\u043F\u0435\u0440\u0435\u0434\u0438 \u0441\u0446\u0435\u043D\u0430\u0440\u0438\u0439 \u0441\u0430\u043C \u043D\u0438\u0447\u0435\u0433\u043E \u043D\u0435 \u043D\u0430\u043F\u0438\u0448\u0435\u0442",
+  customTime: "\u0421\u0432\u043E\u0451 \u0432\u0440\u0435\u043C\u044F",
+  customTimePlaceholder: "15 \u043C\u0438\u043D, 1 \u0447 30 \u043C\u0438\u043D, 2 \u0434\u043D\u044F",
+  customTimeInvalid: "\u041D\u0435 \u043F\u043E\u043D\u044F\u043B \u0432\u0440\u0435\u043C\u044F \u2014 \u043D\u0430\u043F\u0440\u0438\u043C\u0435\u0440, \xAB1 \u0447 30 \u043C\u0438\u043D\xBB \u0438\u043B\u0438 \xAB2 \u0434\u043D\u044F\xBB",
   day: (day, totalDays) => totalDays === void 0 ? `\u0414\u0435\u043D\u044C ${day}` : `\u0414\u0435\u043D\u044C ${day} \u0438\u0437 ${totalDays}`,
   beforeFirstDay: "\u0414\u043E \u043F\u0435\u0440\u0432\u043E\u0433\u043E \u0434\u043D\u044F"
 };
@@ -624,6 +679,11 @@ var englishFlowTestChatLabels = {
   close: "Close",
   failed: "Something went wrong \u2014 try again",
   nextDay: "To the start of the next day",
+  nextFirstMessage: "To the next reminder",
+  nothingScheduled: "The flow won't write first from here on",
+  customTime: "Custom time",
+  customTimePlaceholder: "15 min, 1h 30m, 2 days",
+  customTimeInvalid: "Couldn't read the time \u2014 try \u201C1h 30m\u201D or \u201C2 days\u201D",
   day: (day, totalDays) => totalDays === void 0 ? `Day ${day}` : `Day ${day} of ${totalDays}`,
   beforeFirstDay: "Before day one"
 };
@@ -633,13 +693,15 @@ var russianFlowLabels = {
   editor: russianFlowEditorLabels,
   clientCard: russianClientCardLabels,
   migrate: russianFlowMigrateLabels,
-  testChat: russianFlowTestChatLabels
+  testChat: russianFlowTestChatLabels,
+  notices: russianFlowNoticeLabels
 };
 var englishFlowLabels = {
   editor: englishFlowEditorLabels,
   clientCard: englishClientCardLabels,
   migrate: englishFlowMigrateLabels,
-  testChat: englishFlowTestChatLabels
+  testChat: englishFlowTestChatLabels,
+  notices: englishFlowNoticeLabels
 };
 
 // src/react/flow-labels.ts
@@ -2486,6 +2548,84 @@ function ClientCardPanel({ skin, ...options }) {
 // src/react/test-chat/flow-test-chat.tsx
 import { createContext as createContext3, useContext as useContext3, useMemo as useMemo5 } from "react";
 
+// src/react/notice-lines.ts
+var MINUTE = 6e4;
+function flowNoticeLines(labels = russianFlowNoticeLabels) {
+  const line = ({ data }) => {
+    const parsed = firstMessageData(data);
+    return parsed ? noticeLine(parsed, labels) : void 0;
+  };
+  return { [FLOW_TIMER_NOTICE]: line, [FLOW_DEADLINE_NOTICE]: line };
+}
+function firstMessageData(data) {
+  if (typeof data !== "object" || data === null) return void 0;
+  const { reasons, silentMs, exit } = data;
+  if (!Array.isArray(reasons) || reasons.length === 0) return void 0;
+  return {
+    reasons: reasons.filter((reason) => typeof reason === "object" && reason !== null && typeof reason.kind === "string"),
+    ...typeof silentMs === "number" && Number.isFinite(silentMs) && { silentMs },
+    ...typeof exit === "object" && exit !== null && { exit }
+  };
+}
+function noticeLine({ reasons, silentMs, exit }, labels) {
+  const silentFor = silentMs === void 0 ? void 0 : labels.silentFor(durationText2(silentMs, labels));
+  const parts = reasons.flatMap((reason) => {
+    switch (reason.kind) {
+      case "silence":
+        return [silentFor ?? labels.silence];
+      case "morning":
+        return [labels.morning];
+      case "daily":
+        return [labels.daily(reason.at)];
+      case "night_messages":
+        return [labels.nightMessages(reason.count)];
+      case "farewell":
+        return [labels.farewell];
+      case "transition":
+        return [deadlineLine(exit, labels)];
+      default:
+        return [];
+    }
+  });
+  if (parts.length === 0) return void 0;
+  const withSilence = silentFor && !reasons.some((reason) => reason.kind === "silence") ? [...parts, silentFor] : parts;
+  return labels.wroteFirst(withSilence.join(labels.separator));
+}
+function deadlineLine(exit, labels) {
+  const when = exit?.when;
+  const title = typeof exit?.stateTitle === "string" && exit.stateTitle ? exit.stateTitle : void 0;
+  const condition = when?.type === "timer" ? timerText(when, labels) : void 0;
+  return when?.type === "timer" && when.from === "since_start" ? labels.overallDeadline(condition, title) : labels.stateDeadline(condition, title);
+}
+var UNIT_MS = { min: MINUTE, h: 60 * MINUTE, d: 24 * 60 * MINUTE };
+function timerText(when, labels) {
+  const { conditions } = labels;
+  switch (when.from) {
+    case "state_days":
+      return conditions.stateDays(durationText2(when.days * UNIT_MS.d, labels));
+    case "program_day":
+      return conditions.programDay(when.day);
+    case "time_of_day":
+      return conditions.timeOfDay(when.at);
+    default: {
+      const span = UNIT_MS[when.unit];
+      if (span === void 0) return void 0;
+      const duration = durationText2(when.amount * span, labels);
+      return when.from === "silence" ? conditions.silence(duration) : when.from === "in_state" ? conditions.inState(duration) : conditions.sinceStart(duration);
+    }
+  }
+}
+function durationText2(ms, labels) {
+  const minutes = Math.round(ms / MINUTE);
+  if (minutes < 1) return labels.lessThanMinute;
+  const { day, hour, minute } = labels.units;
+  return [
+    [Math.floor(minutes / (24 * 60)), day],
+    [Math.floor(minutes / 60) % 24, hour],
+    [minutes % 60, minute]
+  ].filter(([amount]) => amount > 0).map(([amount, unit]) => `${amount} ${unit}`).join(" ");
+}
+
 // src/react/test-chat/use-flow-test-chat.ts
 import { useCallback as useCallback5, useEffect as useEffect4, useRef as useRef4, useState as useState6 } from "react";
 var RUN_POLL_MS = 1e3;
@@ -2503,6 +2643,7 @@ function useFlowTestChat(connection, flow) {
   const [timeOffset, setTimeOffset] = useState6(0);
   const [busy, setBusy] = useState6(false);
   const [failed, setFailed] = useState6(false);
+  const [nothingScheduled, setNothingScheduled] = useState6(false);
   const [run, setRun] = useState6(null);
   const latest = useRef4({ connection, flow, chatId });
   latest.current = { connection, flow, chatId };
@@ -2523,9 +2664,14 @@ function useFlowTestChat(connection, flow) {
   const work = useCallback5(async (job) => {
     setBusy(true);
     setFailed(false);
+    setNothingScheduled(false);
     try {
       await job();
     } catch (error) {
+      if (error?.code === "nothing_scheduled") {
+        setNothingScheduled(true);
+        return;
+      }
       console.error("[flow] test chat:", error);
       setFailed(true);
     } finally {
@@ -2556,6 +2702,7 @@ function useFlowTestChat(connection, flow) {
     timeOffset,
     busy,
     failed,
+    nothingScheduled,
     stateId: chatId === null ? null : run?.state ?? flow.start,
     visited: run?.visited ?? NOTHING_VISITED,
     day: chatId === null ? null : run?.day ?? null,
@@ -2566,18 +2713,19 @@ function useFlowTestChat(connection, flow) {
     close: () => setOpened(false),
     reset: () => void start(),
     advance: (ms) => shift2((id) => latest.current.connection.advance(id, ms)),
-    nextDay: connection.advanceToNextDay ? () => shift2((id) => latest.current.connection.advanceToNextDay(id)) : null
+    nextDay: connection.advanceToNextDay ? () => shift2((id) => latest.current.connection.advanceToNextDay(id)) : null,
+    nextFirstMessage: connection.advanceToNextFirstMessage ? () => shift2((id) => latest.current.connection.advanceToNextFirstMessage(id)) : null
   };
 }
 
 // src/react/test-chat/flow-test-chat.tsx
 import { jsx as jsx4 } from "react/jsx-runtime";
-var MINUTE = 6e4;
-var HOUR = 60 * MINUTE;
+var MINUTE2 = 6e4;
+var HOUR = 60 * MINUTE2;
 var DAY = 24 * HOUR;
-var DEFAULT_ADVANCE_STEPS = [20 * MINUTE, 3 * HOUR, DAY];
+var DEFAULT_ADVANCE_STEPS = [20 * MINUTE2, 3 * HOUR, DAY];
 function formatDuration(ms, units) {
-  const minutes = Math.round(ms / MINUTE);
+  const minutes = Math.round(ms / MINUTE2);
   const parts = [
     [Math.floor(minutes / (24 * 60)), units.day],
     [Math.floor(minutes / 60) % 24, units.hour],
@@ -2620,7 +2768,8 @@ function withTestChat(skin) {
   return { ...skin, FlowHeader: Header, FlowEditorFrame: Frame, FlowStateNode: StateNode };
 }
 function FlowTestChat({ testChat, advanceSteps = DEFAULT_ADVANCE_STEPS, skin, ...editor }) {
-  const labels = useFlowLabels().testChat;
+  const { testChat: labels, notices } = useFlowLabels();
+  const noticeLines = useMemo5(() => flowNoticeLines(notices), [notices]);
   const controller = useFlowTestChat(testChat, editor.value);
   const testSkin = useMemo5(() => withTestChat(skin), [skin]);
   const state = controller.stateId === null ? void 0 : stateById(editor.value, controller.stateId);
@@ -2633,11 +2782,17 @@ function FlowTestChat({ testChat, advanceSteps = DEFAULT_ADVANCE_STEPS, skin, ..
       onAdvance: controller.advance,
       day: formatDayLine(controller.day, (editor.now?.() ?? Date.now()) + controller.timeOffset, editor.timeZone ?? browserTimeZone2(), labels),
       ...controller.nextDay && editor.value.schedule ? { onNextDay: controller.nextDay } : {},
+      ...controller.nextFirstMessage && { onNextFirstMessage: controller.nextFirstMessage, nothingScheduled: controller.nothingScheduled },
+      onAdvanceText: (text) => {
+        const ms = parseDuration(text);
+        if (ms !== void 0) controller.advance(ms);
+        return ms !== void 0;
+      },
       busy: controller.busy,
       failed: controller.failed,
       onReset: controller.reset,
       onClose: controller.close,
-      children: controller.chatId === null ? null : testChat.renderChat(controller.chatId)
+      children: controller.chatId === null ? null : testChat.renderChat(controller.chatId, { noticeLines })
     }
   ) : null;
   return /* @__PURE__ */ jsx4(TestChatContext.Provider, { value: { controller, panel }, children: /* @__PURE__ */ jsx4(FlowEditor, { skin: testSkin, ...editor }) });
@@ -2654,11 +2809,14 @@ export {
   chooseNothing,
   conditionText,
   englishFlowLabels,
+  englishFlowNoticeLabels,
+  flowNoticeLines,
   formatClockOffset,
   formatDayLine,
   formatDuration,
   nextQuestionField,
   russianFlowLabels,
+  russianFlowNoticeLabels,
   sameFlow,
   setKnownValue,
   simulationChoices,