Concierge.
Безопасный слой действий для веб-приложений, готовых к работе с агентами.
Типизированные действия, доступные только с согласия, позволяют AI-агенту работать с вашим веб-приложением, не захватывая браузер.
Три пакета, один набор выпусков
Установите базовую среду выполнения для интеграции, независимой от фреймворка, а затем добавьте подходящий адаптер. Устанавливайте и обновляйте пакеты вместе, чтобы у всех адаптеров зависимость разрешалась в одну и ту же физическую копию ядра.
$ pnpm add @full-self-browsing/concierge zod$ pnpm add @full-self-browsing/concierge@^0.2 \
@full-self-browsing/concierge-react@^0.2 zodВерсия 0.2.1 — поддерживаемый публичный предварительный выпуск, работающий по контракту среды выполнения v2. Корневые точки входа пакетов React и Svelte безопасны для использования на сервере; их привязки к среде выполнения находятся в /client и /client.svelte. Развёртывание на edge-платформах не входит в матрицу поддержки версии 0.2.
Публикуйте действия, а не интерфейс страницы
Обычная автоматизация браузера восстанавливает намерение по структуре страницы, селекторам или координатам. Concierge позволяет приложению, поддерживающему взаимодействие с агентами, публиковать именно те действия, которые AI-агенту разрешено использовать в текущий момент.
Расширение FSB работает с сайтами, которые не поддерживают взаимодействие с агентами. Concierge — слой действий для приложений, которые такое взаимодействие поддерживают. Эти проекты относятся к разным частям стека для работы агентов в браузере.
От объявления до структурированного результата
Приложение определяет именованные действия с описаниями, схемами входных данных, правилами доступности, метаданными эффектов, политикой скрытия данных и обработчиками.
Concierge сводит активный этап и доступные на нём действия в один неизменяемый снимок каталога с ревизией, локальной для экземпляра.
Модель получает только те инструменты, которые допускает этот снимок.
Concierge повторно проверяет каждое запрошенное действие перед выполнением, применяет правила согласия и планирования и отклоняет устаревшие или конфликтующие вызовы.
Мост приложения выполняет подтверждённую операцию в интерфейсе и возвращает структурированный результат.
Приложение
Определения действий, текущее состояние, операции в интерфейсе, аутентификация и серверная авторизация.
Concierge
Допуск в каталог, валидация, согласие, планирование, дедупликация, диспетчеризация и сценарии.
Интеграция с моделью
Представление инструментов, вызовы модели, сопоставление вызовов инструментов и доставка результатов.
Объявите действие. Соберите один каталог.
Определите каждое действие как именованную константу, привяжите его к этапу и соберите один атомарный снимок каталога для текущего состояния приложения.
- Этап, доступность, инструменты и ревизия определяются вместе
- Действие допускается только при литеральном значении true; любое другое значение его блокирует
- Собранный каталог глубоко заморожен и никогда не даёт полномочий в другой среде выполнения
import { createBridge, createConcierge, defineAction, offPageResult } from "@full-self-browsing/concierge";
import { z } from "zod";
const projectBridge = createBridge<{
actions: { openProject(id: string): void };
snapshot: { activeProject(): string | null };
}>("project-ui");
const openProject = defineAction({
name: "openProject",
description: "Open one project in the application preview.",
schema: z.object({ projectId: z.string().min(1).max(64) }).strict(),
jsonSchema: {
type: "object",
properties: { projectId: { type: "string", minLength: 1, maxLength: 64 } },
required: ["projectId"],
additionalProperties: false,
},
redact: ({ projectId }) => ({ projectId }),
effects: { readOnly: false, destructive: false, idempotent: true },
handler: ({ args, bridge }) => {
if (bridge === null) {
return offPageResult("Project opening", "project interface");
}
bridge.actions.openProject(args.projectId);
return { ok: true, message: `Opened project ${args.projectId}.` };
},
});
const concierge = createConcierge({
stages: [
{
id: "projects",
match: (context) => context.pathname === "/projects",
actions: [openProject],
bridge: projectBridge,
},
],
});
const catalog = concierge.resolveCatalog({ pathname: "/projects" });
// → catalog.stage · catalog.revision · catalog.tools one snapshotБазовая среда выполнения и привязки к фреймворкам
Публичные пакеты образуют один фиксированный набор выпусков и используют общий контракт среды выполнения v2.
@full-self-browsing/conciergeНезависимая от фреймворка среда выполнения для каталога, диспетчеризации, согласия, сценариев, телеметрии и транспорта.
@full-self-browsing/concierge-reactКонтекст React, жизненный цикл моста и необязательная визуализация активности, включая ConciergeActivityOverlay.
@full-self-browsing/concierge-svelteКонтекст Svelte, жизненный цикл моста и нормализация реактивных снимков.
Один экземпляр, несколько точек входа
Подключите один и тот же экземпляр Concierge и реестр мостов через подходящий адаптер. Состояние на основе геттеров остаётся актуальным, пока Concierge не сделает снимок для валидации или согласия.
Исходные значения onToolCall — только данные для отображения. Они никогда не управляют приложением. Подписанный мост проверяет конверт, помечает его ключ защиты от повторной отправки как использованный, сравнивает конверт с актуальным каталогом браузера и только после этого передаёт его в диспетчеризацию ядра.
Что гарантирует среда выполнения
Dispatch outcome
completedГраница минимальных полномочий, а не система аутентификации
Модель безопасности
Concierge не аутентифицирует пользователей, а запись о согласии на клиенте — это не серверная авторизация. Сервер, выполняющий защищённую операцию, должен самостоятельно аутентифицировать текущего субъекта, авторизовать конкретное действие и полезные данные по действующей политике, отклонять повторные запросы и делать операцию идемпотентной или транзакционной.
Подписанный AI-мост аутентифицирует краткоживущее решение сервера допустить один конкретный пакет действий браузера. Он не делает выходные данные модели заслуживающими доверия, не устраняет XSS-уязвимости и не превращает состояние клиента в серверные полномочия.
Прочитайте SECURITY.md, прежде чем выпускать интеграцию, действия которой имеют серьёзные последствия.
Телеметрия
Подключённые среды выполнения React и Svelte по умолчанию отправляют анонимные оценки использования в конвейер агрегированной статистики проекта FSB. Интеграции без фреймворка подключают телеметрию явно через точку входа /telemetry, доступную только в браузере; она также предоставляет APIs для получения статуса и отказа от телеметрии.
Телеметрия никогда не отправляет имена действий, аргументы, результаты, схемы, этапы, URLs страниц, содержимое DOM, названия приложений или идентификаторы аккаунтов. Если хранилище браузера недоступно, телеметрия останавливается, не влияя на диспетчеризацию.
Прочитайте контракт конфиденциальности телеметрии — в нём описаны передаваемые данные, срок хранения и удаление.
Позвольте AI-агенту действовать, не отдавая ему браузер
TypeScript в приоритете, только ESM, лицензия MIT. Пакеты опубликованы в пространстве имён @full-self-browsing реестра npm.