Cordis, ядро в основе системы

Контекст - это репозиторий служб

Каждый плагин получает контекст, который по соглашению называется ctx. Службы находятся в нем под постоянными ключами, такими как ctx.tools, ctx.llm или ctx.sessions. Плагин, которому нужна таблица инструментов, обращается к ключу, а не к конкретной реализации, поэтому реализация, скрытая за этим ключом, может меняться незаметно для плагина.

import type { Context } from 'cordis'

// Services live on the context under stable keys.
// A plugin reaches for the key, not for a concrete class.
export function apply(ctx: Context) {
  ctx.tools     // the tool table
  ctx.sessions  // the append-only session log
  ctx.llm       // whichever model adapter is loaded
}

Плагин - это все, что реализует Service

На практике это означает функцию с телом apply(ctx) или класс, расширяющий Service, жизненный цикл которого Cordis встраивает в текущий контекст. Здесь нет манифеста регистрации или базового класса плагина, от которого нужно наследоваться.

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

Плагин перечисляет необходимые ему компоненты в inject. Cordis удерживает его в состоянии ожидания, пока не появится каждый из перечисленных сервисов, после чего вызывает apply. Никто не управляет порядком загрузки вручную, и плагин, который загружается раньше своей зависимости, просто ожидает вместо аварийного завершения.

export const inject = ['tools', 'sessions']

export function apply(ctx: Context) {
  // Cordis holds this plugin in a pending state until both
  // services exist, so neither lookup below can be undefined.
  const session = ctx.sessions.current()
  ctx.tools.list().forEach((tool) => session.note(tool.name))
}

Внутри apply гарантируется наличие всего, что указано в inject.

Побочные эффекты обратимы

Регистрации, выполненные через ctx.on и ctx.effect, отслеживаются. Когда плагин выгружается или перезагружается, Cordis проходит по этим записям и отменяет каждую из них. Слушатели удаляются, сервисы освобождаются, таймеры очищаются. Именно это делает горячую замену плагина безопасной, предотвращая постепенную утечку памяти.

export function apply(ctx: Context) {
  const dispose = ctx.tools.register('read_file', async ({ path }) => {
    return readFile(path, 'utf8')
  })

  // Returning the disposer is what makes the plugin removable:
  // unloading it takes the tool back out of the table.
  return dispose
}