Zero / Durable Zero · карта реальных подключений

1. Назначение модуля, публичный entry и контракт; выбранный слот или коллекция, различия add/replace/remove.
2. Пример отдельного consumer-пакета без приватных импортов; требования к capabilities и версии.
3. Владение ресурсами: кто создаёт, отменяет и закрывает; поведение при ошибке, reload и отключении клиента.
4. Проверка фактического исполнения: вход → consumer → содержательный результат, abort/reopen и ошибки для затронутого сценария.
5. Документация ограничений и честный статус проверки: source trace, component test, native acceptance — не одно и то же.

Вход: assembleDurableZero({ engine })

Сейчас: IAgentEngine → PiDurableEngine по умолчанию → SessionCoordinator.engine.start / submit / abort / close

Как заменить: Передать другую реализацию IAgentEngine в основной API сборки.

Ограничение: Generic engine получает stdio/Core, но сборка не возвращает ему native view/controller; terminal host требует эти порты.

Проверка: Есть fast-path mock-engine тест; это не доказательство совместимости любого engine с native terminal.

• packages/runner/src/composition.ts:83
  if (options.engine) {
• packages/core/src/session/coordinator.ts:81
  return await this.engine.submit(input, options);
• packages/runner/src/composition.ts:216
  ...(nativeEngine ? { view: nativeEngine.view, controller: nativeEngine.controller, isIdle: () => nativeEngine!.isIdle() } : {}),
• packages/local-runtime/src/index.ts:89
  if (!instance.view || !instance.controller) throw new Error("The terminal runtime requires native presentation and control ports");

Вход: assembleDurableZero({ nativeExecutionEnvFactory })

Сейчас: SDK NodeExecutionEnv по умолчанию → ExecutionEnvs → Harness.env → filesystem / exec tools

Как заменить: Передать factory(target, chordContext), возвращающую SDK ExecutionEnv.

Ограничение: Нельзя одновременно передать Core factory. Полный SDK-контракт обязателен; CLI/socket-host не выставляют этот параметр.

Проверка: В native-env-seam.test.ts есть реальные startup/file-effect проверки. В этом разборе не перезапускались.

• packages/runner/src/composition.ts:121
  options.nativeExecutionEnvFactory ??
• packages/adapter-pi-durable/src/engine/harness-setup.ts:161
  const created = await this.#nativeFactory(target, context);

Вход: assembleDurableZero({ executionEnvFactory })

Сейчас: IExecutionEnvironment → CoreExecutionEnvAdapter → ExecutionEnvs → native Harness.env

Как заменить: Передать свою Core factory; можно использовать adapter из пакета execution.

Ограничение: Core SPI уже native SDK; неподдержанные расширенные операции дают typed unsupported, это не полная замена любого native backend.

Проверка: В native-env-seam.test.ts есть native startup + effect через custom Core factory; здесь не перезапускались.

• packages/runner/src/composition.ts:65
  if (options.executionEnvFactory && options.nativeExecutionEnvFactory) {
• packages/adapter-pi-durable/src/engine/harness-setup.ts:174
  const createdCore = await this.#coreFactory({ cwd: key, conversationId: target.conversationId });
• packages/adapter-pi-durable/src/engine/harness-setup.ts:182
  adapter = new CoreExecutionEnvAdapter(createdCore, key);

Вход: assembleDurableZero({ extensions, skills, noGlobalExtensions })

Сейчас: DefaultResourceLoader + ExtensionRunner → installExtensionTools → native Registry; pending providers → ModelRuntime

Как заменить: Передать пути extensions/skills; расширение регистрирует tools/providers через Pi API.

Ограничение: Это работающий путь добавления, но не API удаления/замены стандартных builtins или интегратора MCP.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:89
  ...(options.extensions ?? (options.extension ? [options.extension] : [])),
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:102
  await resourceLoader.reload();
• packages/adapter-pi-durable/src/engine/extension-mount.ts:141
  installExtensionTools(registry, adapted);

Вход: assembleDurableZero({ stdin, stdout, onNotification })

Сейчас: Readable/Writable + callback → StdioJsonRpcServer и coordinator.events

Как заменить: Передать свои streams и слушатель уведомлений.

Ограничение: Заменяются IO/наблюдатель, не сама transport strategy; socket-host использует именно этот путь.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:161
  ...(options.stdin !== undefined ? { stdin: options.stdin } : {}),
• packages/runner/src/composition.ts:199
  options.onNotification?.("session/event", payload);
• packages/local-runtime/src/index.ts:78
  ...options, sessionDir: resolve(options.sessionDir), noGlobalExtensions: true, stdin: input, stdout: output,

Вход: runDurableTui(source, controller, settings, ...)

Сейчас: TerminalViewSource / TerminalController / TerminalSettings → terminal-ui/vendor/experimental/durable/tui.js

Как заменить: Своя оболочка может передать реализации трёх UI-контрактов в библиотечную функцию.

Ограничение: Это локальная DI на UI-границе. Native DurableView — намеренная concrete UI-зависимость, не утечка в Core.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/terminal-ui/src/index.d.ts:50
  export function runDurableTui(source: TerminalViewSource, controller: TerminalController, settings: TerminalSettings,
• packages/local-terminal/src/main.ts:33
  const selected = await runDurableTui(client, client, {

Вход: PiDurableEngine.dependencies.modelRuntime

Сейчас: Pi ModelRuntime; fallback ModelRuntime.create() → Harness.open({ models: modelRuntime }); controller.setModel

Как заменить: Собрать PiDurableEngine/openDurable с dependencies.modelRuntime; верхний recipe придётся адаптировать.

Ограничение: assembleDurableZero не принимает этот слот. Требуется native ModelRuntime contract, не Core IModelProvider.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-types.ts:37
  readonly modelRuntime?: ModelRuntime;
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:77
  const modelRuntime = deps?.modelRuntime ?? (await ModelRuntime.create());
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:193
  { models: modelRuntime, registry, settings, env: envs.env, onReport: report },

Вход: PiDurableEngine.dependencies.nativeProviders

Сейчас: SDK Provider[] → modelRuntime.registerNativeProvider(provider)

Как заменить: Передать nativeProviders на нижнем уровне; через Pi extensions также есть registerProvider/native-provider путь.

Ограничение: provider/model строки выбирают модель, но не заменяют ModelRuntime. Прямой список providers не открыт верхним recipe.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-types.ts:38
  readonly nativeProviders?: readonly Provider[];
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:78
  for (const provider of deps?.nativeProviders ?? []) {
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:59
  try { modelRuntime.registerNativeProvider(provider); } catch (err) { logRegError("native provider", provider?.id ?? "unknown", err); }

Вход: PiDurableEngine.dependencies.settingsManager

Сейчас: Native SettingsManager → createHarnessSettings; model defaults; resource loading

Как заменить: Передать совместимый native SettingsManager на нижнем уровне.

Ограничение: Верхний runner всегда создаёт SettingsManager.create(cwd). Это native тип, не произвольный zero-neutral config provider.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:92
  const settingsManager = SettingsManager.create(cwd);
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:85
  const settingsManager = deps?.settingsManager ?? SettingsManager.create(location.cwd);

Вход: PiDurableEngine.dependencies.resourceLoader

Сейчас: DefaultResourceLoader; extension-pi-resource оборачивает его → reload/getExtensions/getSkills → prompt и ExtensionRunner

Как заменить: Передать native-compatible loader при ручной сборке PiDurableEngine/openDurable.

Ограничение: Основная фабрика всегда создаёт DefaultResourceLoader. extension-pi-resource — data/wiring wrapper, а не отдельный универсальный resource backend.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:94
  const resourceLoader = new DefaultResourceLoader({
• packages/adapter-pi-durable/src/engine/runtime-types.ts:39
  readonly resourceLoader?: DefaultResourceLoader;
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:92
  deps?.resourceLoader ??
• packages/extension-pi-resource/src/pi-resource-ext.ts:32
  return Object.assign(baseExt, {

Вход: dependencies.builtins / openDurable.builtins или plugins

Сейчас: BuiltinExtension[] (контракт в adapter-pi-durable) → createCodingRegistry → builtinRegistry.initAll(ctx)

Как заменить: Нижний API принимает дополнительные BuiltinExtension. Сам контракт содержит native Registry/SettingsManager.

Ограничение: Верхний runner передаёт только штатный codemode. На нижнем уровне список добавляется к coding-tools/subagents, не заменяет их.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-loader.ts:129
  ...(deps?.builtins ?? []),
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:130
  ...(options.builtins ?? options.plugins ?? []),
• packages/adapter-pi-durable/src/engine/harness-setup.ts:86
  builtinRegistry.register(codingToolsExtension);
• packages/adapter-pi-durable/src/engine/builtin-extensions/types.ts:10
  registry?: Registry;

Вход: dependencies.builtins: [свой codemode]

Сейчас: adapter-codemode → createCodemodeExtension → BuiltinExtension.register → registry.install(ext)

Как заменить: Через ручную нижнюю сборку выбрать другой codemode-builtin вместо пакета adapter-codemode.

Ограничение: Основной runner жёстко вызывает createCodemodeBuiltinExtension(); добавлять второй codemode поверх его списка нельзя.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:86
  codemodeBuiltin = createCodemodeBuiltinExtension();
• packages/runner/src/composition.ts:116
  builtins: [codemodeBuiltin],
• packages/adapter-codemode/src/codemode.ts:35
  ctx.registry.install(ext);

Вход: dependencies.prompt / openDurable.prompt

Сейчас: PromptOptions: systemPromptPath/contextFiles/... → createPiPrompt → buildSections

Как заменить: Нижний API принимает PromptOptions; paths/sections меняют содержимое.

Ограничение: Сам renderer createPiPrompt обязателен. resourceLoader/dynamicSections в итоговых options подставляются runtime-loader сверху.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-loader.ts:132
  const promptOptions = deps?.prompt ?? options.prompt;
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:137
  { ...promptOptions, resourceLoader, dynamicSections },
• packages/adapter-pi-durable/src/engine/prompt.ts:122
  const systemPromptOverride = tryReadPromptFile(options.systemPromptPath, "system-prompt");

Вход: dependencies.dynamicSections

Сейчас: DynamicPromptSections по умолчанию → ExtensionRunner и createPiPrompt читают/обновляют sections

Как заменить: Передать совместимый объект на нижнем уровне.

Ограничение: Верхний assembleDurableZero не выставляет этот параметр.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-loader.ts:116
  const dynamicSections = deps?.dynamicSections ?? new DynamicPromptSections();
• packages/adapter-pi-durable/src/engine/extension-mount.ts:219
  dynamicSections.updateSections(beforeStart.systemPromptOptions.sections);

Вход: Нет factory/constructor option

Сейчас: new CodemodeSandbox() внутри register → createCodemodeExtension({ sandbox })

Как заменить: Сейчас — заменить весь codemode builtin нижним API либо менять adapter-codemode; независимого sandboxFactory нет.

Ограничение: Нельзя передать другой sandbox основному codemode адаптеру снаружи.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-codemode/src/codemode.ts:24
  const sandbox = new CodemodeSandbox();
• packages/adapter-codemode/src/codemode.ts:29
  const ext = createCodemodeExtension({

Вход: Всегда добавляется в createCodingRegistry

Сейчас: coding-tools.ts → SDK CodingTools/createCodingTools → native Registry → read/write/edit/bash tools

Как заменить: Для полной замены builtin нужен иной recipe/изменение bootstrap: выбрать финальный список до регистрации.

Ограничение: customBuiltins с тем же id отклоняется. Это не утверждение, что Pi extensions вообще не могут переопределить отдельное имя tool.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/harness-setup.ts:86
  builtinRegistry.register(codingToolsExtension);
• packages/adapter-pi-durable/src/engine/builtin-extensions/registry.ts:8
  if (this.#extensions.has(extension.id)) {
• packages/adapter-pi-durable/src/engine/builtin-extensions/coding-tools.ts:18
  ctx.registry.install(tools);

Вход: Всегда добавляется в createCodingRegistry

Сейчас: builtin-extensions/subagents.ts → native Registry → SDK subagent extension

Как заменить: Для замены/исключения целого builtin изменить конфигурационный bootstrap, не снимать защиту от неявных дублей.

Ограничение: Настройка policy — другое: меняет данные политики, не реализацию builtin.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/harness-setup.ts:87
  builtinRegistry.register(subagentsExtension);
• packages/adapter-pi-durable/src/engine/builtin-extensions/subagents.ts:6
  id: "subagents",

Вход: runner extensionFactories: createMcpExtension()

Сейчас: Native Pi MCP ExtensionFactory → ResourceLoader → ExtensionRunner → adapted tools

Как заменить: Конфигурация серверов — Pi config; замена самого интегратора требует собственного resource loader/recipe.

Ограничение: Отдельного upper-level mcpFactory нет. В текущем main MCP status больше не является startup readiness barrier; readiness вызывается перед native tool snapshots, cleanup — через session_shutdown. Это не слот замены интегратора.

Проверка: Изменённый startup/tool path прослежен по исходникам main; runtime/MCP тесты при обновлении атласа не запускались.

• packages/runner/src/composition.ts:98
  extensionFactories: [{ name: "mcp", factory: createMcpExtension() }],
• packages/adapter-pi-durable/src/engine/extension-mount.ts:194
  for (const ready of mcpReadiness) await ready({

Вход: Создаются/устанавливаются внутри Pi bootstrap

Сейчас: createToolSearchExtension + DynamicCodemodeNamespaces → native registry / extension tool sync

Как заменить: Отдельного внешнего factory option нет; для смены реализации менять Pi bootstrap или реализовывать свой backend.

Ограничение: Это internal Pi integration, не готовый generic Zero slot.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/harness-setup.ts:104
  registry.install(createToolSearchExtension());
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:117
  const dynamicNamespaces = new DynamicCodemodeNamespaces();

Вход: Всегда registry.install(createPiPrompt(...))

Сейчас: adapter-pi-durable/engine/prompt.ts → native registry sections

Как заменить: Для другой реализации renderer нужен иной конфигурационный bootstrap.

Ограничение: PromptOptions позволяют менять данные, не выбирать другой renderer.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/harness-setup.ts:105
  registry.install(createPiPrompt(settingsManager, cwd, promptOptions));
• packages/adapter-pi-durable/src/engine/prompt.ts:121
  export function createPiPrompt(_settings: SettingsManager, fallbackCwd: string, options: PromptOptions = {}) {

Вход: runner: new StdioJsonRpcServer(...)

Сейчас: protocol/StdioJsonRpcServer implements ITransportStrategy → Inline handler → SessionCoordinator

Как заменить: Streams доступны сверху, но transportFactory/ITransportStrategy в assemble options отсутствует. Для иной стратегии — собственный host/bootstrap.

Ограничение: Socket-host оборачивает stdio через PassThrough; это реальный другой host, а не injected transport strategy.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:160
  const server = new StdioJsonRpcServer({
• packages/protocol/src/transport/stdio-server.ts:13
  export class StdioJsonRpcServer implements ITransportStrategy {
• packages/local-runtime/src/index.ts:104
  const bridge = new StdioJsonRpcServer({

Вход: local-terminal/main.ts: fixed dynamic import

Сейчас: @local-durable/terminal-ui.runDurableTui → ZeroTerminalClient через Native view/controller contract

Как заменить: Другой frontend может использовать RPC client и свои widgets, но main не принимает render/UI factory.

Ограничение: Терминал опционален и не является частью ядра headless/backendless Zero. В готовом terminal entrypoint выбор UI фиксирован; другой frontend использует свой entrypoint/клиент.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/local-terminal/src/main.ts:21
  const { runDurableTui } = await import("@local-durable/terminal-ui");
• packages/local-terminal/src/main.ts:33
  const selected = await runDurableTui(client, client, {

Вход: runtime-loader: openNodeSqliteStorage(location.database)

Сейчас: SDK SQLite storage → Harness.open → native sessions/tasks/documents

Как заменить: Никакого storageFactory в текущем Pi recipe нет. Для другого native storage нужен отдельный обоснованный adapter seam; другой backend возможен через engine SPI.

Ограничение: Это намеренно конкретный Pi-backed backend, не требование заменить SQLite сейчас. Core ISessionStore не управляет этим запуском.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-loader.ts:192
  await openNodeSqliteStorage(location.database),
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:191
  harness = await Harness.open(

Вход: PiDurableEngine → openDurable → Harness.open

Сейчас: @earendil-works/pi-durable + Chord → Model/tool/session execution; view/controller создаёт adapter

Как заменить: В Durable реализации сохраняется один native Harness. Для другого engine есть внешний IAgentEngine слот.

Ограничение: Отдельный HarnessFactory не выставлен. Не требуется инъектировать каждую SDK-внутренность или создавать второй execution loop.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/adapter-pi-durable/src/engine/runtime-loader.ts:191
  harness = await Harness.open(
• packages/adapter-pi-durable/src/engine/pi-durable-engine.ts:81
  this.#instance = await openDurable({

Вход: Есть в пакетах; в standard recipe не подключён

Сейчас: PiAiModelProvider; setupRunnerModels → Самостоятельный model-setup helper, не native runtime-loader

Как заменить: Не считать наличие Core порта рабочим способом смены моделей в штатном Harness; реальный нижний слот — native modelRuntime.

Ограничение: Не нужно механически заставлять native Harness работать через этот unused generic port.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/core/src/models/provider.ts:6
  export interface IModelProvider {
• packages/adapter-pi-ai/src/model-setup.ts:74
  const modelProvider = new PiAiModelProvider(modelRuntime, settingsManager);
• packages/adapter-pi-durable/src/engine/runtime-loader.ts:77
  const modelRuntime = deps?.modelRuntime ?? (await ModelRuntime.create());

Вход: Есть standalone adapter; coordinator принимает только engine/sessionDir

Сейчас: PiDurableSessionStore implements ISessionStore → Не mounted в native reference startup

Как заменить: В этой сборке заменить store через Core нельзя: native SQLite открывается отдельно.

Ограничение: Не вводить параллельного владельца native session ради использования существующего интерфейса.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/core/src/session/store.ts:8
  export interface ISessionStore {
• packages/adapter-pi-durable/src/store.ts:51
  export class PiDurableSessionStore implements ISessionStore {
• packages/core/src/session/coordinator.ts:27
  constructor(options: SessionCoordinatorOptions) {

Вход: runner HostBridge(requester), Core IHostBridge; Pi dependencies.hostBridge — placeholder

Сейчас: HostBridge и legacy HostRpcManager существуют отдельно → Сборщик не создаёт HostBridge; dependencies.hostBridge в execution path не читается

Как заменить: Для рабочего BB integration нужен реальный mount native host tools и request/response routing; DI поле само ничего не подключает.

Ограничение: Core bridge и пустой Pi IHostBridge — разные типы. Legacy module globals не являются приемлемым DI решением.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/host/host-bridge.ts:24
  export class HostBridge implements IHostBridge {
• packages/adapter-pi-durable/src/engine/runtime-types.ts:36
  readonly hostBridge?: IHostBridge;
• packages/adapter-pi-durable/src/engine/host-rpc.ts:104
  let activeToolForwarder: ((toolName: string, args: unknown) => Promise<{ content: Array<{ type: "text"; text: string }>; isError: boolean }>) | null = null;

Вход: CodemodeExtension implements ISandboxExtension

Сейчас: Lifecycle metadata id/name/version/teardown → Нет метода create/execute sandbox в этом Core SPI

Как заменить: Это не sandbox injection point; реальная замена sandbox требует factory в codemode adapter либо другого builtin.

Ограничение: Не принимать implements интерфейса за возможность подменить конкретный CodemodeSandbox.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/core/src/tools/sandbox.ts:6
  export interface ISandboxExtension {
• packages/adapter-codemode/src/codemode.ts:6
  export class CodemodeExtension implements BuiltinExtension, ISandboxExtension {
• packages/adapter-codemode/src/codemode.ts:24
  const sandbox = new CodemodeSandbox();

Вход: createSessionDispatcher(options) существует

Сейчас: runner/dispatch/session-dispatcher.ts → В reference composition свой ограниченный inline handler

Как заменить: Не считать методы helper/schema автоматически mounted; production routing нужно подключать и проверять отдельно.

Ограничение: Замена resolver/container не реализует отсутствующие tools/register, binding/fork capabilities.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/dispatch/session-dispatcher.ts:20
  export function createSessionDispatcher(options: SessionDispatcherOptions): MethodHandler {
• packages/runner/src/composition.ts:163
  handler: async (method: string, params: Record<string, unknown>) => {

Вход: Можно явно использовать его NodeExecutionEnv в Core factory

Сейчас: @durable-zero/execution vs native SDK NodeExecutionEnv → По умолчанию runner импортирует SDK env/node, не execution package

Как заменить: Пакет можно выбрать в своём executionEnvFactory; он не является default native execution backend.

Ограничение: Наличие workspace dependency в manifest не значит, что она включена в production recipe.

Проверка: Не запускался новый runtime-тест; оценка по исходникам.

• packages/runner/src/composition.ts:10
  import { NodeExecutionEnv } from "@earendil-works/pi-durable/env/node";
• packages/execution/src/adapters/local-node-env.ts:16
  export class LocalNodeExecutionEnv implements IExecutionEnvironment {

Вход: DurableController.executeMcpCommand(args, ui)

Сейчас: Native MCP handler + предоставленный ExtensionUIContext → local-runtime MCP UI bridge → terminal RPC events

Как заменить: Передать custom/select/input/notify/theme через UI-контекст команды или использовать session/mcpCommand. Headless context всего runtime не заменяется.

Ограничение: Это native Durable controller boundary, не универсальная замена MCP-интегратора и не обязательный UI ядра. Один активный manager принадлежит конкретному соединению.

Проверка: Публичная сигнатура и реальный handler/consumer проверены по исходникам; native UI тесты не перезапускались.

• packages/adapter-pi-durable/src/engine/runtime-types.ts:112
  executeMcpCommand(args: string, ui: Pick<ExtensionUIContext, "custom" | "select" | "input" | "notify" | "theme">): Promise<void>;
• packages/adapter-pi-durable/src/engine/runtime-controller.ts:75
  await registered.handler(args, { ...context, ui: { ...context.ui, ...ui }, mode: "tui", hasUI: true });
• packages/local-runtime/src/index.ts:135
  const ui = createMcpCommandUI(request,

Вход: local-runtime attachAssembly → openSessionCatalog(...)

Сейчас: Filesystem SessionCatalog: list / describe / rename / create → session/list, session/describe, session/rename, session/create

Как заменить: Сейчас выбрать иной metadata catalog можно только своим host recipe / изменением bootstrap; catalogFactory не передаётся.

Ограничение: Это только host metadata: имена, cwd и набор extensions. Native entries/models/tasks/locks остаются у Harness; каталог не является вторым владельцем исполнения или session store.

Проверка: Конструктор, metadata-only граница и реальные RPC consumers прослежены по main; runtime тесты не запускались.

• packages/local-runtime/src/index.ts:85
  catalog = await openSessionCatalog(assemblyOptions.sessionDir!, assemblyOptions.cwd ?? process.cwd(), configuredExtensions);
• packages/local-runtime/src/sessions.ts:17
  /** Host catalog metadata only. Native entries, models, tasks and locks remain in the Harness. */
• packages/local-runtime/src/index.ts:172
  case "session/list": return catalog.list();