@ai-projector/ide 0.0.0-stage → 0.11.0

package/packages/core/modules/agent-role/index.js

@@ -0,0 +1,187 @@
+export const SERVICE_AGENT = "projector";
+export const SERVICE_ROLE_IDS = ["doctor", "lens", "judge"];
+/** The roles Projector runs without a chat: a fixed prompt, no tools and one model call. */
+export const BUILTIN_SERVICE_ROLES = [
+    {
+        id: "doctor",
+        name: "Доктор",
+        description: "Чинит сломанную Vue-разметку форм и готовых ответов.",
+        kind: "service",
+        agent: SERVICE_AGENT,
+        selection: {},
+        builtin: true,
+    },
+    {
+        id: "lens",
+        name: "Lens",
+        description: "Пишет короткую подпись о том, чем занят агент сейчас.",
+        kind: "service",
+        agent: SERVICE_AGENT,
+        selection: {},
+        builtin: true,
+    },
+    {
+        id: "judge",
+        name: "Судья",
+        description: "Оценивает риск действия перед подтверждением.",
+        kind: "service",
+        agent: SERVICE_AGENT,
+        selection: {},
+        builtin: true,
+    },
+];
+export function isServiceRoleId(value) {
+    return typeof value === "string" && SERVICE_ROLE_IDS.includes(value);
+}
+export function isBuiltinServiceRole(value) {
+    return isServiceRoleId(value);
+}
+export const ROLE_ID = /^[a-z][a-z0-9-]{1,39}$/;
+export const ROLE_LIMITS = {
+    name: 80,
+    description: 400,
+    agent: 40,
+    selection: 24,
+    key: 100,
+    value: 300,
+    prompt: 8_000,
+    resources: 40,
+    resource: 80,
+};
+/** Skill, command and MCP server names: ordered, unique and bounded. `[]` is a real choice. */
+export function normalizeRoleResources(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const names = [];
+    for (const item of value.slice(0, ROLE_LIMITS.resources)) {
+        if (typeof item !== "string")
+            continue;
+        const name = item.trim();
+        if (!name || name.length > ROLE_LIMITS.resource || names.includes(name))
+            continue;
+        names.push(name);
+    }
+    return names;
+}
+/** The role's own instructions; an empty prompt means the role adds none. */
+export function normalizeRolePrompt(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const prompt = value.trim().slice(0, ROLE_LIMITS.prompt);
+    return prompt ? prompt : undefined;
+}
+/**
+ * Keeps only the entries a control can use. A damaged settings file must not make the whole role
+ * unreadable: an unknown value is dropped and the control keeps its default.
+ */
+export function normalizeRoleSelection(value) {
+    const selection = {};
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return selection;
+    for (const [key, item] of Object.entries(value).slice(0, ROLE_LIMITS.selection)) {
+        if (typeof item !== "string")
+            continue;
+        const cleanKey = key.trim();
+        const clean = item.trim();
+        if (!cleanKey || cleanKey.length > ROLE_LIMITS.key || !clean)
+            continue;
+        if (clean.length > ROLE_LIMITS.value)
+            continue;
+        selection[cleanKey] = clean;
+    }
+    return selection;
+}
+/** Validates a role from a file or an API request; anything ambiguous is rejected, not guessed. */
+export function normalizeAgentRole(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const row = value;
+    const id = typeof row.id === "string" ? row.id.trim() : "";
+    if (!ROLE_ID.test(id))
+        return undefined;
+    const name = typeof row.name === "string" ? row.name.trim().slice(0, ROLE_LIMITS.name) : "";
+    if (!name)
+        return undefined;
+    const kind = row.kind === "chat" || row.kind === "service" ? row.kind : undefined;
+    if (!kind)
+        return undefined;
+    const agent = typeof row.agent === "string" ? row.agent.trim().slice(0, ROLE_LIMITS.agent) : "";
+    if (!agent)
+        return undefined;
+    if (kind === "service" && agent !== SERVICE_AGENT)
+        return undefined;
+    const permissionMode = kind === "chat" &&
+        (row.permissionMode === "default" ||
+            row.permissionMode === "auto" ||
+            row.permissionMode === "bypassPermissions")
+        ? row.permissionMode
+        : undefined;
+    const description = typeof row.description === "string"
+        ? row.description.trim().slice(0, ROLE_LIMITS.description)
+        : "";
+    const prompt = normalizeRolePrompt(row.prompt);
+    const skills = normalizeRoleResources(row.skills);
+    const mcp = normalizeRoleResources(row.mcp);
+    return {
+        id,
+        name,
+        kind,
+        agent,
+        selection: normalizeRoleSelection(row.selection),
+        ...(description ? { description } : {}),
+        ...(permissionMode ? { permissionMode } : {}),
+        ...(row.isolate === true ? { isolate: true } : {}),
+        ...(prompt ? { prompt } : {}),
+        ...(skills !== undefined ? { skills } : {}),
+        ...(mcp !== undefined ? { mcp } : {}),
+    };
+}
+/** The settings a call should use: the role's own values over the chat's fallback. */
+export function resolveRoleSelection(role, fallback) {
+    return { ...fallback, ...role?.selection };
+}
+/** A service role follows the chat when it names no Projector provider of its own. */
+export function serviceRoleInheritsModel(role) {
+    return !role.selection.provider;
+}
+/** The values a chat keeps from its role; the role id and name stay readable after deletion. */
+export function snapshotOfRole(role) {
+    return {
+        roleId: role.id,
+        name: role.name,
+        selection: { ...role.selection },
+        ...(role.permissionMode ? { permissionMode: role.permissionMode } : {}),
+        ...(role.prompt ? { prompt: role.prompt } : {}),
+        ...(role.skills !== undefined ? { skills: [...role.skills] } : {}),
+        ...(role.mcp !== undefined ? { mcp: [...role.mcp] } : {}),
+    };
+}
+/** Validates a snapshot from history or a tab; a damaged one is ignored instead of guessed. */
+export function normalizeRoleSnapshot(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const row = value;
+    const roleId = typeof row.roleId === "string" ? row.roleId.trim() : "";
+    if (!ROLE_ID.test(roleId))
+        return undefined;
+    const name = typeof row.name === "string" ? row.name.trim().slice(0, ROLE_LIMITS.name) : "";
+    if (!name)
+        return undefined;
+    const permissionMode = row.permissionMode === "default" ||
+        row.permissionMode === "auto" ||
+        row.permissionMode === "bypassPermissions"
+        ? row.permissionMode
+        : undefined;
+    const prompt = normalizeRolePrompt(row.prompt);
+    const skills = normalizeRoleResources(row.skills);
+    const mcp = normalizeRoleResources(row.mcp);
+    return {
+        roleId,
+        name,
+        selection: normalizeRoleSelection(row.selection),
+        ...(permissionMode ? { permissionMode } : {}),
+        ...(prompt ? { prompt } : {}),
+        ...(skills !== undefined ? { skills } : {}),
+        ...(mcp !== undefined ? { mcp } : {}),
+    };
+}

package/packages/core/modules/agent-task/contract.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/**
+ * A subagent or a background command that works next to an agent's answer. Every agent adapter
+ * reports its own kinds of them in this one shape; the chat shows and stores only this.
+ */
+export const agentTaskSchema = z.object({
+    id: z.string(),
+    kind: z.enum(["agent", "shell", "other"]),
+    title: z.string(),
+    status: z.enum(["running", "done", "error", "stopped"]),
+    /** Runs without blocking the answer. */
+    background: z.boolean(),
+    /** Kind of the subagent (`Explore`, `general-purpose`, ...). */
+    subagent: z.string().optional(),
+    /** The agent's own session of the subagent: its whole conversation can be read from there. */
+    session: z.string().optional(),
+    /** What it was asked to do, as the agent gave it. */
+    prompt: z.string().optional(),
+    /** The tool call that started it. */
+    tool: z.string().optional(),
+    /** The agent does not report when it ends: its state is unknown once the answer is over. */
+    untracked: z.boolean().optional(),
+    /** One line about what it does now, or how it ended. */
+    summary: z.string().optional(),
+    lastTool: z.string().optional(),
+    tools: z.number().optional(),
+    tokens: z.number().optional(),
+    durationMs: z.number().optional(),
+    /** When the task started and ended (ms since the epoch); the chat fills them in as it sees them. */
+    startedAt: z.number().optional(),
+    endedAt: z.number().optional(),
+    /** What it reported while working, oldest first; the chat collects it from the patches. */
+    log: z.array(z.string()).optional(),
+});

package/packages/core/modules/agent-task/index.js

@@ -0,0 +1 @@
+export { agentTaskSchema } from "./contract.js";

package/packages/core/modules/agent-widgets/bars/index.js

@@ -0,0 +1,11 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const barsWidget = defineWidget({
+    name: "Bars",
+    group: "data",
+    summary: "горизонтальные столбцы",
+    props: {
+        items: { type: "array", description: "[{label, value}]", required: true },
+        unit: { type: "string", description: "единица после значения" },
+    },
+    example: "<Bars unit=\" ₽\" :items=\"[{label:'A',value:120},{label:'B',value:80}]\" />",
+});

package/packages/core/modules/agent-widgets/button/index.js

@@ -0,0 +1,19 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const buttonWidget = defineWidget({
+    name: "Button",
+    group: "action",
+    summary: "кнопка; отправляет данные агенту только по клику пользователя",
+    props: {
+        submit: { type: "boolean", description: "отправить значения окружающей <Form>" },
+        reset: { type: "boolean", description: "вернуть поля формы к исходным" },
+        preset: { type: "object", description: "задать поля формы по имени: {поле: значение}" },
+        send: { type: "string | object", description: "отправить это агенту как есть (вне формы)" },
+        summary: { type: "string", description: "строка перед данными в сообщении" },
+        sentLabel: { type: "string", description: "подпись после отправки, по умолчанию «Отправлено»" },
+    },
+    slot: "подпись кнопки",
+    notes: [
+        "После отправки кнопка и форма блокируются. Без submit/send/preset/reset это обычная кнопка с @click.",
+    ],
+    example: '<Button send="Да, продолжай" summary="Ответ">Продолжить</Button>',
+});

package/packages/core/modules/agent-widgets/card/index.js

@@ -0,0 +1,13 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const cardWidget = defineWidget({
+    name: "Card",
+    group: "layout",
+    summary: "рамка с заголовком для группы",
+    props: {
+        title: { type: "string", description: "заголовок" },
+        hint: { type: "string", description: "подпись под заголовком" },
+        tone: { type: "'neutral' | 'warning'", description: "цвет рамки" },
+    },
+    slot: "содержимое рамки",
+    example: '<Card title="Итоги" hint="за квартал">Выручка выросла на 12%.</Card>',
+});

package/packages/core/modules/agent-widgets/checks/index.js

@@ -0,0 +1,19 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const checksWidget = defineWidget({
+    name: "Checks",
+    group: "form",
+    summary: "выбор из списка: несколько (флажки) или один (single)",
+    hidden: true,
+    props: {
+        options: {
+            type: "array",
+            description: "массив строк или объектов: value обязателен, label и hint необязательны",
+            required: true,
+        },
+        single: { type: "boolean", description: "один вариант вместо нескольких" },
+        name: { type: "string", description: "имя поля в <Form>" },
+        initial: { type: "array", description: "начально выбранные value" },
+    },
+    model: { type: "array", description: "выбранные value" },
+    example: "<Checks name=\"scripts\" :initial=\"['test']\" :options=\"[{value:'start',hint:'dev-сервер'},'test']\" />",
+});

package/packages/core/modules/agent-widgets/chips/index.js

@@ -0,0 +1,15 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const chipsWidget = defineWidget({
+    name: "Chips",
+    group: "data",
+    summary: "набор цветных меток: теги, статусы, технологии",
+    props: {
+        items: {
+            type: "string | {label, tone?, icon?}[]",
+            description: "метки; tone — neutral, info, success, warning, danger или accent; icon — имя из InlineIcon. Без tone цвета чередуются автоматически",
+            required: true,
+        },
+        mono: { type: "boolean", description: "моноширинный шрифт для кода, хешей и версий" },
+    },
+    example: `<Chips :items="['TypeScript',{label:'готово',tone:'success',icon:'circle-check'},{label:'риск',tone:'warning',icon:'alert'}]" />`,
+});

package/packages/core/modules/agent-widgets/columns/index.js

@@ -0,0 +1,12 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const columnsWidget = defineWidget({
+    name: "Columns",
+    group: "layout",
+    summary: "колонки; на узкой ширине встают в столбик",
+    props: {
+        cols: { type: "number", description: "число колонок, по умолчанию 2" },
+        gap: { type: "number", description: "отступ в пикселях" },
+    },
+    slot: "элементы по колонкам",
+    example: '<Columns :cols="2"><Stat label="A" value="10" /><Stat label="B" value="20" /></Columns>',
+});

package/packages/core/modules/agent-widgets/donut/index.js

@@ -0,0 +1,11 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const donutWidget = defineWidget({
+    name: "Donut",
+    group: "data",
+    summary: "кольцо с долями и легендой",
+    props: {
+        items: { type: "array", description: "[{label, value}]", required: true },
+        center: { type: "string", description: "текст в центре" },
+    },
+    example: "<Donut center=\"100%\" :items=\"[{label:'A',value:60},{label:'B',value:40}]\" />",
+});

package/packages/core/modules/agent-widgets/field/index.js

@@ -0,0 +1,39 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const fieldWidget = defineWidget({
+    name: "Field",
+    group: "form",
+    summary: "поле формы; type задаёт вид контроля",
+    props: {
+        type: {
+            type: "string",
+            description: "text, textarea, number, slider, select, radio, checks, switch, date, time или segmented; по умолчанию text",
+        },
+        name: { type: "string", description: "имя поля в Form" },
+        label: { type: "string", description: "подпись поля" },
+        hint: { type: "string", description: "пояснение под полем" },
+        initial: {
+            type: "string | number | boolean | array",
+            description: "начальное значение; для checks — массив, для switch — boolean",
+        },
+        placeholder: { type: "string", description: "подсказка в пустом text, textarea или number" },
+        required: { type: "boolean", description: "обязательное поле" },
+        disabled: { type: "boolean", description: "заблокировать поле" },
+        options: {
+            type: "array",
+            description: "для select, radio и checks: строки или {value, label, hint}",
+        },
+        min: { type: "number", description: "минимум для number и slider" },
+        max: { type: "number", description: "максимум для number и slider" },
+        step: { type: "number", description: "шаг для number и slider" },
+        unit: { type: "string", description: "единица рядом со значением number и slider" },
+        rows: { type: "number", description: "высота textarea в строках" },
+    },
+    model: { type: "string | number | boolean | array", description: "значение поля" },
+    guide: [
+        "type: text | textarea | number | slider | select | radio | checks | switch | date | time | segmented.",
+        "Общие: name, label, hint, initial, placeholder, required, disabled.",
+        "options — для select/radio/checks; min/max/step/unit — для number/slider; rows — для textarea.",
+        "checks отдаёт array, switch — boolean, number/slider — number, остальные — string.",
+    ].join("\n"),
+    example: '<Field type="select" name="mode" label="Режим" :options="[\'server\',\'window\']" />\n<Field type="slider" name="port" label="Порт" :min="3000" :max="9000" :initial="4177" />',
+});

package/packages/core/modules/agent-widgets/form/index.js

@@ -0,0 +1,18 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const formWidget = defineWidget({
+    name: "Form",
+    group: "form",
+    summary: "форма без скрипта: собирает именованные поля внутри",
+    answer: true,
+    slot: "поля Field с name и кнопки",
+    notes: [
+        "Поля внутри — Field с name; начальное значение задаётся initial. У Button флаг submit отправляет значения полей тебе и блокирует форму, summary задаёт подпись ответа, reset возвращает исходные значения, а preset принимает объект с новыми значениями полей.",
+        "Когда нужен выбор или настройки пользователя: покажи форму с submit-кнопкой и остановись; действуй после его ответа и только по выбранному.",
+        "Форма последним блоком ответа становится полем ввода чата: пользователь заполнит её на месте текстового поля, а его сообщение сохранит ту же форму с выбранными значениями. Не пиши текст после такой формы.",
+    ],
+    guide: [
+        "Поля — Field с name; Button submit отправляет JSON, reset/preset меняют значения.",
+        "Форма последним блоком ответа становится полем ввода; не пиши текст после неё.",
+    ].join("\n"),
+    example: '<Form><Field type="checks" name="scripts" :options="[\'start\',\'test\']" /><Button submit summary="Выбор">Применить</Button></Form>',
+});

package/packages/core/modules/agent-widgets/git-info/index.js

@@ -0,0 +1,29 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const gitInfoWidget = defineWidget({
+    name: "GitInfo",
+    group: "data",
+    summary: "состояние и история git: ветка, изменения, diff, коммиты — когда ответ опирается на репозиторий",
+    props: {
+        branch: { type: "string", description: "текущая ветка" },
+        upstream: { type: "string", description: "upstream-ветка, например origin/main" },
+        ahead: { type: "number", description: "коммитов впереди upstream" },
+        behind: { type: "number", description: "коммитов позади upstream" },
+        clean: { type: "boolean", description: "рабочее дерево чистое" },
+        staged: { type: "number", description: "изменений в индексе" },
+        unstaged: { type: "number", description: "неиндексированных изменений" },
+        untracked: { type: "number", description: "неотслеживаемых файлов" },
+        conflicted: { type: "number", description: "конфликтующих файлов" },
+        additions: { type: "number", description: "добавленных строк в diff" },
+        deletions: { type: "number", description: "удалённых строк в diff" },
+        commits: {
+            type: "[{hash, subject, author?, when?}]",
+            description: "последние коммиты; when — готовая подпись времени",
+        },
+        files: {
+            type: "[{path, status?, additions?, deletions?}]",
+            description: "изменённые файлы; status — M, A, D, R и т. п.",
+        },
+    },
+    special: true,
+    example: '<GitInfo branch="main" upstream="origin/main" :ahead="2" :staged="3" :unstaged="1" :untracked="2" :additions="48" :deletions="12" :commits="[{hash:\'a1b2c3d\',subject:\'Добавить GitInfo\',author:\'Ада\',when:\'2 ч назад\'}]" :files="[{path:\'core/modules/agent-widgets/git-info/index.ts\',status:\'A\',additions:48,deletions:0}]" />',
+});

package/packages/core/modules/agent-widgets/image/index.js

@@ -0,0 +1,22 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const imageWidget = defineWidget({
+    name: "Image",
+    group: "data",
+    summary: "изображение с подписью",
+    props: {
+        src: {
+            type: "string",
+            description: "адрес изображения: URL, data: URI, путь файла проекта или абсолютный путь на диске (/tmp/…, file://, C:\\…)",
+            required: true,
+        },
+        alt: { type: "string", description: "текстовое описание для доступности", required: true },
+        caption: { type: "string", description: "подпись под изображением" },
+        fit: { type: '"contain" | "cover"', description: "вписывание в рамку, по умолчанию contain" },
+        height: { type: "number", description: "высота в пикселях, по умолчанию 240" },
+    },
+    notes: [
+        "Путь разрешается так же, как у markdown-картинки `![alt](путь)`: файл проекта читается из проекта, абсолютный путь — с диска.",
+        "Клик открывает просмотр с масштабом, как у markdown-картинки; битая загрузка заменяется ссылкой с alt.",
+    ],
+    example: '<Image src="https://example.com/chart.png" alt="График продаж" caption="Продажи за квартал" fit="contain" :height="240" />',
+});

package/packages/core/modules/agent-widgets/inline-icon/index.js

@@ -0,0 +1,45 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+/**
+ * Lucide names kept deliberately small: every name is bundled into the chat, and an unknown icon
+ * must not cost an arbitrary network request at render time.
+ */
+export const INLINE_ICON_NAMES = [
+    "alert",
+    "arrow-right",
+    "check",
+    "chevron-right",
+    "circle-check",
+    "clock",
+    "cloud",
+    "code",
+    "database",
+    "external-link",
+    "file",
+    "folder",
+    "git-branch",
+    "git-commit",
+    "info",
+    "lock",
+    "package",
+    "play",
+    "search",
+    "settings",
+    "sparkles",
+    "terminal",
+    "test-tube",
+    "x",
+];
+export const inlineIconWidget = defineWidget({
+    name: "InlineIcon",
+    group: "data",
+    summary: "небольшая иконка внутри строки или рядом с подписью",
+    props: {
+        name: {
+            type: "string",
+            description: `одно из имён: ${INLINE_ICON_NAMES.join(", ")}`,
+            required: true,
+        },
+        label: { type: "string", description: "доступное название; без него иконка декоративная" },
+    },
+    example: '<InlineIcon name="git-branch" label="Ветка" />',
+});

package/packages/core/modules/agent-widgets/input/index.js

@@ -0,0 +1,16 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const inputWidget = defineWidget({
+    name: "Input",
+    group: "form",
+    summary: "строка или многострочный текст",
+    hidden: true,
+    props: {
+        label: { type: "string", description: "подпись" },
+        placeholder: { type: "string", description: "подсказка в пустом поле" },
+        multiline: { type: "boolean", description: "несколько строк" },
+        name: { type: "string", description: "имя поля в <Form>" },
+        initial: { type: "string", description: "начальный текст" },
+    },
+    model: { type: "string", description: "введённый текст" },
+    example: '<Input name="note" label="Комментарий" multiline />',
+});

package/packages/core/modules/agent-widgets/intelligent-form/index.js

@@ -0,0 +1,32 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const intelligentFormWidget = defineWidget({
+    name: "IntelligentForm",
+    group: "form",
+    summary: "форма ответа: поля управления; в поле ввода отправляется общей кнопкой",
+    answer: true,
+    props: {
+        submit: {
+            type: "string",
+            description: "подпись кнопки в сообщении или снимке, по умолчанию «Отправить»",
+        },
+        summary: {
+            type: "string",
+            description: "строка перед данными в сообщении агенту",
+        },
+        sentLabel: {
+            type: "string",
+            description: "подпись кнопки после отправки, по умолчанию «Отправлено»",
+        },
+    },
+    slot: "поля Field с name",
+    notes: [
+        "Когда нужно собрать два параметра или больше либо настройки пользователя, закончи ответ одной IntelligentForm и не пиши текст после неё; не разделяй их на несколько ask_user. Для одного вопроса или одного варианта остаётся ask_user.",
+        "Внутрь положи Field с name. Не оборачивай форму в Card или Form и не добавляй Button submit: в поле ввода отправляет общая кнопка, а в сообщении и снимке — кнопка самой формы.",
+        "Пока форма открыта в поле ввода, её блок не показывается в ответе; не дублируй его текстом.",
+    ],
+    guide: [
+        "Внутрь — Field с name; общая кнопка композера отправляет JSON.",
+        "Не оборачивай в Card/Form и не добавляй Button submit; не пиши текст после формы.",
+    ].join("\n"),
+    example: '<IntelligentForm summary="Настройки проекта" submit="Применить"><Field type="radio" name="mode" :options="[\'server\',\'window\']" /><Field type="number" name="port" label="Порт" :initial="4177" /></IntelligentForm>',
+});

package/packages/core/modules/agent-widgets/line/index.js

@@ -0,0 +1,12 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const lineWidget = defineWidget({
+    name: "Line",
+    group: "data",
+    summary: "линейный график по меткам оси",
+    props: {
+        labels: { type: "array", description: "подписи оси X: ['янв','фев']", required: true },
+        series: { type: "array", description: "[{name, data:[числа]}] по числу меток", required: true },
+        height: { type: "number", description: "высота, по умолчанию 160" },
+    },
+    example: "<Line :labels=\"['янв','фев']\" :series=\"[{name:'Выручка',data:[10,14]}]\" />",
+});

package/packages/core/modules/agent-widgets/row/index.js

@@ -0,0 +1,11 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const rowWidget = defineWidget({
+    name: "Row",
+    group: "layout",
+    summary: "ряд с переносом по ширине (показатели кладут в него)",
+    props: {
+        gap: { type: "number", description: "отступ в пикселях" },
+    },
+    slot: "элементы ряда",
+    example: '<Row><Stat label="A" value="1" /><Stat label="B" value="2" /></Row>',
+});

package/packages/core/modules/agent-widgets/safe-secret-show/index.js

@@ -0,0 +1,21 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const safeSecretShowWidget = defineWidget({
+    name: "SafeSecretShow",
+    group: "data",
+    summary: "секрет от агента: показывает пользователю значение, которое вернёт скрипт, не попадая ни в чат, ни к агенту",
+    props: {
+        script: {
+            type: "string",
+            description: "shell-команда, чей stdout — секрет; выполняется на машине пользователя",
+            required: true,
+        },
+        label: { type: "string", description: "название секрета в панели" },
+        comment: { type: "string", description: "комментарий агента пользователю" },
+    },
+    special: true,
+    notes: [
+        "Секрет не попадает в ответ, историю чата и контекст агента: скрипт выполняется на сервере, а значение показывается только в браузере пользователя.",
+        "Скрипт запускается только по нажатию «Показать секрет»; команда видна под кнопкой. Значение хранится лишь в открытом окне.",
+    ],
+    example: '<SafeSecretShow script="cat ~/.ssh/id_ed25519" label="Приватный ключ SSH" comment="Скопируйте ключ в сервис." />',
+});

package/packages/core/modules/agent-widgets/slider/index.js

@@ -0,0 +1,18 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const sliderWidget = defineWidget({
+    name: "Slider",
+    group: "form",
+    summary: "число на шкале",
+    hidden: true,
+    props: {
+        label: { type: "string", description: "подпись" },
+        min: { type: "number", description: "минимум, по умолчанию 0" },
+        max: { type: "number", description: "максимум, по умолчанию 100" },
+        step: { type: "number", description: "шаг" },
+        unit: { type: "string", description: "единица рядом со значением" },
+        name: { type: "string", description: "имя поля в <Form>" },
+        initial: { type: "number", description: "начальное значение, по умолчанию min" },
+    },
+    model: { type: "number", description: "текущее значение" },
+    example: '<Slider name="port" label="Порт" :min="3000" :max="9000" unit="" :initial="4000" />',
+});

package/packages/core/modules/agent-widgets/stat/index.js

@@ -0,0 +1,16 @@
+import { defineWidget } from "../../widget-catalog/index.js";
+export const statWidget = defineWidget({
+    name: "Stat",
+    group: "data",
+    summary: "показатель: подпись, значение, изменение",
+    props: {
+        label: { type: "string", description: "подпись", required: true },
+        value: { type: "string | number", description: "значение", required: true },
+        delta: {
+            type: "number",
+            description: "изменение в процентах: число без знака %, например 3.6, знак задаёт цвет",
+        },
+        hint: { type: "string", description: "пояснение мелким шрифтом" },
+    },
+    example: '<Stat label="Выручка" value="4,2 млн" :delta="12" hint="к прошлому кварталу" />',
+});