Исследования @full-self-browsing

Concierge.

Безопасный слой действий для веб-приложений, готовых к работе с агентами.

Типизированные действия, доступные только с согласия, позволяют AI-агенту работать с вашим веб-приложением, не захватывая браузер.

▽0.2.1TypeScript-firstESM only · Node >=22.12MIT
Установка

Три пакета, один набор выпусков

Установите базовую среду выполнения для интеграции, независимой от фреймворка, а затем добавьте подходящий адаптер. Устанавливайте и обновляйте пакеты вместе, чтобы у всех адаптеров зависимость разрешалась в одну и ту же физическую копию ядра.

Базовая среда выполнения
$ 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

Публикуйте действия, а не интерфейс страницы

Обычная автоматизация браузера восстанавливает намерение по структуре страницы, селекторам или координатам. Concierge позволяет приложению, поддерживающему взаимодействие с агентами, публиковать именно те действия, которые AI-агенту разрешено использовать в текущий момент.

Обычная автоматизация браузера
Concierge
Кликать по селекторам или координатам
Вызывать действия, определённые приложением
Восстанавливать намерение по видимому интерфейсу
Получать типизированные схемы и данные о доступности в реальном времени
Наследовать широкие полномочия страницы
Видеть только текущий каталог действий
Сводить подтверждение к логическому значению
Привязывать согласие к проверенным полезным данным и снимку состояния
Доверять управление браузером обратному вызову модели
Проверять подписанный пакет действий с защитой от повторной отправки перед запуском

Расширение FSB работает с сайтами, которые не поддерживают взаимодействие с агентами. Concierge — слой действий для приложений, которые такое взаимодействие поддерживают. Эти проекты относятся к разным частям стека для работы агентов в браузере.

Как это работает

От объявления до структурированного результата

01

Приложение определяет именованные действия с описаниями, схемами входных данных, правилами доступности, метаданными эффектов, политикой скрытия данных и обработчиками.

02

Concierge сводит активный этап и доступные на нём действия в один неизменяемый снимок каталога с ревизией, локальной для экземпляра.

03

Модель получает только те инструменты, которые допускает этот снимок.

04

Concierge повторно проверяет каждое запрошенное действие перед выполнением, применяет правила согласия и планирования и отклоняет устаревшие или конфликтующие вызовы.

05

Мост приложения выполняет подтверждённую операцию в интерфейсе и возвращает структурированный результат.

Приложение

Определения действий, текущее состояние, операции в интерфейсе, аутентификация и серверная авторизация.

Concierge

Допуск в каталог, валидация, согласие, планирование, дедупликация, диспетчеризация и сценарии.

Интеграция с моделью

Представление инструментов, вызовы модели, сопоставление вызовов инструментов и доставка результатов.

Быстрый старт

Объявите действие. Соберите один каталог.

Определите каждое действие как именованную константу, привяжите его к этапу и соберите один атомарный снимок каталога для текущего состояния приложения.

  • Этап, доступность, инструменты и ревизия определяются вместе
  • Действие допускается только при литеральном значении true; любое другое значение его блокирует
  • Собранный каталог глубоко заморожен и никогда не даёт полномочий в другой среде выполнения
actions/open-project.ts
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

Независимая от фреймворка среда выполнения для каталога, диспетчеризации, согласия, сценариев, телеметрии и транспорта.

React@full-self-browsing/concierge-react

Контекст React, жизненный цикл моста и необязательная визуализация активности, включая ConciergeActivityOverlay.

Svelte@full-self-browsing/concierge-svelte

Контекст Svelte, жизненный цикл моста и нормализация реактивных снимков.

Node.js>=22.12.0
Module formatESM only
React · React DOM^18.2.0 || ^19.0.0
Svelte^5.0.0
AI SDK core^6.0.0 || ^7.0.0
Runtime contractv2 throughout 0.2.x
Интеграции

Один экземпляр, несколько точек входа

Подключите один и тот же экземпляр Concierge и реестр мостов через подходящий адаптер. Состояние на основе геттеров остаётся актуальным, пока Concierge не сделает снимок для валидации или согласия.

Интеграция
Точка входа среды выполнения
Рекомендации
Без фреймворка
@full-self-browsing/concierge
Используйте базовую среду выполнения и зарегистрируйте мост приложения напрямую.
React
/concierge-react/client
Передайте экземпляр ядра, зарегистрируйте мосты и при необходимости отрисуйте оверлей активности.
Svelte
/concierge-svelte/client.svelte
Передайте экземпляр ядра вместе с нормализатором снимков Svelte и зарегистрируйте мосты во время инициализации.
AI SDK 6 & 7
/concierge/ai-sdk
Преобразуйте собранный каталог в инструменты модели и сопоставляйте завершённые вызовы.
Подписанный серверный мост
/ai-sdk/server · /ai-sdk/browser
Выпускайте, проверяйте и отправляйте на выполнение краткоживущие пакеты действий браузера, привязанные к дайджесту каталога.

Исходные значения onToolCall — только данные для отображения. Они никогда не управляют приложением. Подписанный мост проверяет конверт, помечает его ключ защиты от повторной отправки как использованный, сравнивает конверт с актуальным каталогом браузера и только после этого передаёт его в диспетчеризацию ядра.

Гарантии среды выполнения

Что гарантирует среда выполнения

Dispatch outcome

completed
nameopenProject
callIdcall_7f2c · index 0
catalogRevisionstage projects · fresh
consentbound · consumed once
dedupesession · response · callId
onDispatchredacted lifecycle
Входные данные действий повторно проверяются непосредственно перед выполнением, а действия с побочными эффектами проходят через окно фиксации, в течение которого их можно отменить.
Точные повторы используют один общий Promise и не могут выполниться дважды в пределах окна дедупликации; при изменении действия, входных данных, хода диалога или ревизии возвращается identity_conflict.
Пакеты действий выполняются в порядке outputIndex и возвращают явный итог: успешное завершение или терминальное состояние.
Составные действия используют управляемые ядром дочернюю диспетчеризацию, очистку, задержку и ограниченную цепочку происхождения — 16 уровней вложенности и 256 шагов на корневой сценарий.
Смешанные установки версий 0.1 и 0.2 завершаются ошибкой ещё до регистрации моста или диспетчеризации.
Безопасность и конфиденциальность

Граница минимальных полномочий, а не система аутентификации

Модель безопасности

Concierge не аутентифицирует пользователей, а запись о согласии на клиенте — это не серверная авторизация. Сервер, выполняющий защищённую операцию, должен самостоятельно аутентифицировать текущего субъекта, авторизовать конкретное действие и полезные данные по действующей политике, отклонять повторные запросы и делать операцию идемпотентной или транзакционной.

Подписанный AI-мост аутентифицирует краткоживущее решение сервера допустить один конкретный пакет действий браузера. Он не делает выходные данные модели заслуживающими доверия, не устраняет XSS-уязвимости и не превращает состояние клиента в серверные полномочия.

Прочитайте SECURITY.md, прежде чем выпускать интеграцию, действия которой имеют серьёзные последствия.

Телеметрия

Подключённые среды выполнения React и Svelte по умолчанию отправляют анонимные оценки использования в конвейер агрегированной статистики проекта FSB. Интеграции без фреймворка подключают телеметрию явно через точку входа /telemetry, доступную только в браузере; она также предоставляет APIs для получения статуса и отказа от телеметрии.

Телеметрия никогда не отправляет имена действий, аргументы, результаты, схемы, этапы, URLs страниц, содержимое DOM, названия приложений или идентификаторы аккаунтов. Если хранилище браузера недоступно, телеметрия останавливается, не влияя на диспетчеризацию.

Прочитайте контракт конфиденциальности телеметрии — в нём описаны передаваемые данные, срок хранения и удаление.

Позвольте AI-агенту действовать, не отдавая ему браузер

TypeScript в приоритете, только ESM, лицензия MIT. Пакеты опубликованы в пространстве имён @full-self-browsing реестра npm.