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

package/dist/types/format/flow-schema.d.ts

@@ -0,0 +1,605 @@
+import { z } from "zod";
+export declare const DEFAULT_SIDE_QUESTION_EVERY_MESSAGES = 5;
+/** Схема сценария текущей версии формата. Вход — JSON без значений по умолчанию, выход — `AgentFlow`. */
+export declare const agentFlowSchema: z.ZodPipe<z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    format: z.ZodLiteral<"agent-flow">;
+    version: z.ZodLiteral<2>;
+    id: z.ZodString;
+    name: z.ZodString;
+    start: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    common: z.ZodDefault<z.ZodString>;
+    pace: z.ZodDefault<z.ZodObject<{
+        sideQuestionEveryMessages: z.ZodDefault<z.ZodInt>;
+    }, z.core.$strict>>;
+    clientCard: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        about: z.ZodDefault<z.ZodString>;
+        type: z.ZodDefault<z.ZodEnum<{
+            boolean: "boolean";
+            choice: "choice";
+            number: "number";
+            text: "text";
+        }>>;
+        options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        refreshAfterMonths: z.ZodDefault<z.ZodNullable<z.ZodInt>>;
+    }, z.core.$strict>>>;
+    chatNotes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        about: z.ZodDefault<z.ZodString>;
+        type: z.ZodDefault<z.ZodEnum<{
+            boolean: "boolean";
+            choice: "choice";
+            number: "number";
+            text: "text";
+        }>>;
+        options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    anyState: z.ZodDefault<z.ZodObject<{
+        except: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        exits: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            when: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"judge">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"data">;
+                field: z.ZodString;
+                op: z.ZodDefault<z.ZodEnum<{
+                    contains: "contains";
+                    eq: "eq";
+                    filled: "filled";
+                    gt: "gt";
+                    lt: "lt";
+                    ne: "ne";
+                }>>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"event">;
+                event: z.ZodEnum<{
+                    app: "app";
+                    button: "button";
+                    message: "message";
+                    tool: "tool";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodEnum<{
+                    in_state: "in_state";
+                    silence: "silence";
+                    since_start: "since_start";
+                }>;
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"time_of_day">;
+                at: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"state_days">;
+                days: z.ZodInt;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"program_day">;
+                day: z.ZodNumber;
+            }, z.core.$strict>], "from">], "type">;
+            to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    states: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodDefault<z.ZodLiteral<"state">>;
+        title: z.ZodDefault<z.ZodString>;
+        instructions: z.ZodDefault<z.ZodString>;
+        firstMessage: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        learn: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        noSideQuestions: z.ZodDefault<z.ZodBoolean>;
+        tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        exits: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            when: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"judge">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"data">;
+                field: z.ZodString;
+                op: z.ZodDefault<z.ZodEnum<{
+                    contains: "contains";
+                    eq: "eq";
+                    filled: "filled";
+                    gt: "gt";
+                    lt: "lt";
+                    ne: "ne";
+                }>>;
+                value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"event">;
+                event: z.ZodEnum<{
+                    app: "app";
+                    button: "button";
+                    message: "message";
+                    tool: "tool";
+                }>;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodEnum<{
+                    in_state: "in_state";
+                    silence: "silence";
+                    since_start: "since_start";
+                }>;
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"time_of_day">;
+                at: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"state_days">;
+                days: z.ZodInt;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"timer">;
+                from: z.ZodLiteral<"program_day">;
+                day: z.ZodNumber;
+            }, z.core.$strict>], "from">], "type">;
+            to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>>>;
+        nudges: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            afterSilence: z.ZodArray<z.ZodObject<{
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>>;
+            dailyAt: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            giveUpAfter: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>>;
+            days: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodLiteral<"off">]>>;
+    }, z.core.$strict>>;
+    layout: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        dayStart: z.ZodString;
+        nightFrom: z.ZodOptional<z.ZodString>;
+        lateStartHours: z.ZodDefault<z.ZodNumber>;
+        lengthDays: z.ZodOptional<z.ZodInt>;
+        deadlineState: z.ZodOptional<z.ZodString>;
+        farewellOnDeadline: z.ZodDefault<z.ZodBoolean>;
+        farewellText: z.ZodOptional<z.ZodString>;
+        firstMessages: z.ZodOptional<z.ZodObject<{
+            maxPerDay: z.ZodOptional<z.ZodInt>;
+            morning: z.ZodOptional<z.ZodBoolean>;
+            skipMorningIfHumanWithinMin: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>>;
+        nudges: z.ZodOptional<z.ZodObject<{
+            afterSilence: z.ZodArray<z.ZodObject<{
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>>;
+            dailyAt: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            giveUpAfter: z.ZodOptional<z.ZodObject<{
+                amount: z.ZodNumber;
+                unit: z.ZodEnum<{
+                    d: "d";
+                    h: "h";
+                    min: "min";
+                }>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        dayFrame: z.ZodOptional<z.ZodObject<{
+            softFrom: z.ZodOptional<z.ZodInt>;
+            hardAt: z.ZodOptional<z.ZodInt>;
+            hardText: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    nudges: z.ZodOptional<z.ZodObject<{
+        afterSilence: z.ZodArray<z.ZodObject<{
+            amount: z.ZodNumber;
+            unit: z.ZodEnum<{
+                d: "d";
+                h: "h";
+                min: "min";
+            }>;
+        }, z.core.$strict>>;
+        dailyAt: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        giveUpAfter: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            unit: z.ZodEnum<{
+                d: "d";
+                h: "h";
+                min: "min";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    sideTasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+        when: z.ZodOptional<z.ZodString>;
+        field: z.ZodOptional<z.ZodString>;
+        maxAttempts: z.ZodDefault<z.ZodInt>;
+        perConversation: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    afterEnd: z.ZodOptional<z.ZodEnum<{
+        reply: "reply";
+        silent: "silent";
+    }>>;
+}, z.core.$strict>, z.ZodTransform<{
+    format: "agent-flow";
+    version: 2;
+    id: string;
+    name: string;
+    start: string | null;
+    common: string;
+    pace: {
+        sideQuestionEveryMessages: number;
+    };
+    clientCard: {
+        id: string;
+        name: string;
+        about: string;
+        type: "boolean" | "choice" | "number" | "text";
+        options: string[];
+        refreshAfterMonths: number | null;
+    }[];
+    chatNotes: {
+        id: string;
+        name: string;
+        about: string;
+        type: "boolean" | "choice" | "number" | "text";
+        options: string[];
+    }[];
+    tools: string[];
+    anyState: {
+        except: string[];
+        exits: {
+            id: string;
+            when: {
+                type: "data";
+                field: string;
+                op: "contains" | "eq" | "filled" | "gt" | "lt" | "ne";
+                value?: string | number | boolean | undefined;
+            } | {
+                type: "timer";
+                from: "in_state" | "silence" | "since_start";
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | {
+                type: "timer";
+                from: "time_of_day";
+                at: string;
+            } | {
+                type: "timer";
+                from: "state_days";
+                days: number;
+            } | {
+                type: "timer";
+                from: "program_day";
+                day: number;
+            } | {
+                type: "judge";
+                text: string;
+            } | {
+                type: "event";
+                event: "app" | "button" | "message" | "tool";
+                name?: string | undefined;
+            };
+            to: string | null;
+        }[];
+    };
+    states: {
+        id: string;
+        kind: "state";
+        title: string;
+        instructions: string;
+        firstMessage: string | null;
+        learn: string[];
+        noSideQuestions: boolean;
+        tools: string[];
+        tags: string[];
+        exits: {
+            id: string;
+            when: {
+                type: "data";
+                field: string;
+                op: "contains" | "eq" | "filled" | "gt" | "lt" | "ne";
+                value?: string | number | boolean | undefined;
+            } | {
+                type: "timer";
+                from: "in_state" | "silence" | "since_start";
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | {
+                type: "timer";
+                from: "time_of_day";
+                at: string;
+            } | {
+                type: "timer";
+                from: "state_days";
+                days: number;
+            } | {
+                type: "timer";
+                from: "program_day";
+                day: number;
+            } | {
+                type: "judge";
+                text: string;
+            } | {
+                type: "event";
+                event: "app" | "button" | "message" | "tool";
+                name?: string | undefined;
+            };
+            to: string | null;
+        }[];
+        nudges?: "off" | {
+            afterSilence: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            }[];
+            dailyAt?: string[] | undefined;
+            giveUpAfter?: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | undefined;
+            days?: number | undefined;
+        } | undefined;
+    }[];
+    layout: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    schedule?: {
+        dayStart: string;
+        nightFrom?: string | undefined;
+        lateStartHours: number;
+        lengthDays?: number | undefined;
+        deadlineState?: string | undefined;
+        farewellOnDeadline: boolean;
+        farewellText?: string | undefined;
+        firstMessages?: {
+            maxPerDay?: number | undefined;
+            morning?: boolean | undefined;
+            skipMorningIfHumanWithinMin?: number | undefined;
+        } | undefined;
+        nudges?: {
+            afterSilence: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            }[];
+            dailyAt?: string[] | undefined;
+            giveUpAfter?: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | undefined;
+        } | undefined;
+        dayFrame?: {
+            softFrom?: number | undefined;
+            hardAt?: number | undefined;
+            hardText?: string | undefined;
+        } | undefined;
+    } | undefined;
+    nudges?: {
+        afterSilence: {
+            amount: number;
+            unit: "d" | "h" | "min";
+        }[];
+        dailyAt?: string[] | undefined;
+        giveUpAfter?: {
+            amount: number;
+            unit: "d" | "h" | "min";
+        } | undefined;
+    } | undefined;
+    sideTasks?: {
+        id: string;
+        text: string;
+        when?: string | undefined;
+        field?: string | undefined;
+        maxAttempts: number;
+        perConversation: boolean;
+    }[] | undefined;
+    afterEnd?: "reply" | "silent" | undefined;
+}, {
+    $schema?: string | undefined;
+    format: "agent-flow";
+    version: 2;
+    id: string;
+    name: string;
+    start: string | null;
+    common: string;
+    pace: {
+        sideQuestionEveryMessages: number;
+    };
+    clientCard: {
+        id: string;
+        name: string;
+        about: string;
+        type: "boolean" | "choice" | "number" | "text";
+        options: string[];
+        refreshAfterMonths: number | null;
+    }[];
+    chatNotes: {
+        id: string;
+        name: string;
+        about: string;
+        type: "boolean" | "choice" | "number" | "text";
+        options: string[];
+    }[];
+    tools: string[];
+    anyState: {
+        except: string[];
+        exits: {
+            id: string;
+            when: {
+                type: "data";
+                field: string;
+                op: "contains" | "eq" | "filled" | "gt" | "lt" | "ne";
+                value?: string | number | boolean | undefined;
+            } | {
+                type: "timer";
+                from: "in_state" | "silence" | "since_start";
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | {
+                type: "timer";
+                from: "time_of_day";
+                at: string;
+            } | {
+                type: "timer";
+                from: "state_days";
+                days: number;
+            } | {
+                type: "timer";
+                from: "program_day";
+                day: number;
+            } | {
+                type: "judge";
+                text: string;
+            } | {
+                type: "event";
+                event: "app" | "button" | "message" | "tool";
+                name?: string | undefined;
+            };
+            to: string | null;
+        }[];
+    };
+    states: {
+        id: string;
+        kind: "state";
+        title: string;
+        instructions: string;
+        firstMessage: string | null;
+        learn: string[];
+        noSideQuestions: boolean;
+        tools: string[];
+        tags: string[];
+        exits: {
+            id: string;
+            when: {
+                type: "data";
+                field: string;
+                op: "contains" | "eq" | "filled" | "gt" | "lt" | "ne";
+                value?: string | number | boolean | undefined;
+            } | {
+                type: "timer";
+                from: "in_state" | "silence" | "since_start";
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | {
+                type: "timer";
+                from: "time_of_day";
+                at: string;
+            } | {
+                type: "timer";
+                from: "state_days";
+                days: number;
+            } | {
+                type: "timer";
+                from: "program_day";
+                day: number;
+            } | {
+                type: "judge";
+                text: string;
+            } | {
+                type: "event";
+                event: "app" | "button" | "message" | "tool";
+                name?: string | undefined;
+            };
+            to: string | null;
+        }[];
+        nudges?: "off" | {
+            afterSilence: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            }[];
+            dailyAt?: string[] | undefined;
+            giveUpAfter?: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | undefined;
+            days?: number | undefined;
+        } | undefined;
+    }[];
+    layout: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    schedule?: {
+        dayStart: string;
+        nightFrom?: string | undefined;
+        lateStartHours: number;
+        lengthDays?: number | undefined;
+        deadlineState?: string | undefined;
+        farewellOnDeadline: boolean;
+        farewellText?: string | undefined;
+        firstMessages?: {
+            maxPerDay?: number | undefined;
+            morning?: boolean | undefined;
+            skipMorningIfHumanWithinMin?: number | undefined;
+        } | undefined;
+        nudges?: {
+            afterSilence: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            }[];
+            dailyAt?: string[] | undefined;
+            giveUpAfter?: {
+                amount: number;
+                unit: "d" | "h" | "min";
+            } | undefined;
+        } | undefined;
+        dayFrame?: {
+            softFrom?: number | undefined;
+            hardAt?: number | undefined;
+            hardText?: string | undefined;
+        } | undefined;
+    } | undefined;
+    nudges?: {
+        afterSilence: {
+            amount: number;
+            unit: "d" | "h" | "min";
+        }[];
+        dailyAt?: string[] | undefined;
+        giveUpAfter?: {
+            amount: number;
+            unit: "d" | "h" | "min";
+        } | undefined;
+    } | undefined;
+    sideTasks?: {
+        id: string;
+        text: string;
+        when?: string | undefined;
+        field?: string | undefined;
+        maxAttempts: number;
+        perConversation: boolean;
+    }[] | undefined;
+    afterEnd?: "reply" | "silent" | undefined;
+}>>;

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

@@ -0,0 +1,7 @@
+export * from "./flow-format.js";
+export { agentFlowSchema, DEFAULT_SIDE_QUESTION_EVERY_MESSAGES } from "./flow-schema.js";
+export { parseFlow } from "./parse-flow.js";
+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";

package/dist/types/format/migrate-flow.d.ts

@@ -0,0 +1,4 @@
+type FlowJson = Record<string, unknown>;
+/** Переводит JSON сценария из версии `from` в текущую. Вызывающий проверил, что `from` не новее текущей. */
+export declare function migrateFlow(flow: FlowJson, from: number): FlowJson;
+export {};

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

@@ -0,0 +1,6 @@
+import { type ParseFlowResult } from "./flow-format.js";
+/**
+ * Разбирает сценарий: объект или строку JSON. Старые версии формата переводит в текущую,
+ * пропущенные значения дополняет. Проверяет только форму; связи между состояниями проверяет `checkFlow`.
+ */
+export declare function parseFlow(input: unknown): ParseFlowResult;

package/dist/types/format.d.ts

@@ -0,0 +1,3 @@
+export * from "./format/index.js";
+export * from "./engine/index.js";
+export * from "./check/index.js";

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./format.js";
+export * from "./runtime/index.js";
+export { memoryFlowStore } from "./store/memory.js";
+export type * from "./store/flow-store.js";

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

@@ -0,0 +1,20 @@
+/** Надписи экрана карточки клиента. */
+export interface ClientCardLabels {
+    title: string;
+    empty: string;
+    /** «обновлено 12.10.2026». */
+    updatedAt: (date: string) => string;
+    stale: string;
+    /** Название строки свободного факта («ведёт блог») в списке. */
+    fact: string;
+    forgetField: string;
+    forgetAll: string;
+    forgetAllConfirm: string;
+    confirm: string;
+    cancel: string;
+    loading: string;
+    failed: string;
+    retry: string;
+}
+export declare const russianClientCardLabels: ClientCardLabels;
+export declare const englishClientCardLabels: ClientCardLabels;