agentic-orchestrator 0.1.13 → 0.1.15

package/apps/control-plane/test/worker-provider-adapters.spec.ts

@@ -0,0 +1,440 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ERROR_CODES } from '../src/core/error-codes.js';
+import { ApiWorkerProvider } from '../src/providers/api-worker-provider.js';
+import { CliWorkerProvider } from '../src/providers/cli-worker-provider.js';
+import type { ProviderCommandResult, ProviderSelection } from '../src/providers/providers.js';
+import type { ProviderOutputParser } from '../src/providers/output-parsers/types.js';
+import type { WorkerOutputEnvelope } from '../src/providers/output-parsers/types.js';
+import { GenericCliOutputParser } from '../src/providers/output-parsers/generic-output-parser.js';
+
+const parserContext = {
+  sessionId: 'session-1',
+  role: 'builder',
+  featureId: 'feature-1',
+  provider: 'codex',
+  model: 'local-default',
+};
+
+function makeSelection(
+  provider: string,
+  overrides: Partial<ProviderSelection> = {},
+): ProviderSelection {
+  return {
+    provider,
+    model: `${provider}-model`,
+    provider_config_env: null,
+    provider_config_ref: null,
+    agent_config: null,
+    ...overrides,
+  };
+}
+
+describe('GenericCliOutputParser', () => {
+  it('GIVEN_empty_output_WHEN_parse_THEN_throws_provider_output_invalid', () => {
+    const parser = new GenericCliOutputParser();
+    try {
+      parser.parse('   ', parserContext);
+      throw new Error('expected parse to throw');
+    } catch (error) {
+      expect(error).toMatchObject({ code: ERROR_CODES.PROVIDER_OUTPUT_INVALID });
+    }
+  });
+
+  it('GIVEN_invalid_json_WHEN_parse_THEN_throws_provider_output_invalid', () => {
+    const parser = new GenericCliOutputParser();
+    try {
+      parser.parse('{not-json', parserContext);
+      throw new Error('expected parse to throw');
+    } catch (error) {
+      expect(error).toMatchObject({ code: ERROR_CODES.PROVIDER_OUTPUT_INVALID });
+    }
+  });
+
+  it('GIVEN_object_without_outputs_or_type_WHEN_parse_THEN_throws_provider_output_invalid', () => {
+    const parser = new GenericCliOutputParser();
+    try {
+      parser.parse(JSON.stringify({ session_id: 's-1' }), parserContext);
+      throw new Error('expected parse to throw');
+    } catch (error) {
+      expect(error).toMatchObject({ code: ERROR_CODES.PROVIDER_OUTPUT_INVALID });
+    }
+  });
+
+  it('GIVEN_output_array_WHEN_parse_THEN_filters_non_record_items_and_uses_context_fallbacks', () => {
+    const parser = new GenericCliOutputParser();
+    const parsed = parser.parse(
+      JSON.stringify({
+        outputs: [{ type: 'PATCH', unified_diff: 'diff --git a b' }, 'bad-entry', 12, null],
+      }),
+      parserContext,
+    );
+
+    expect(parsed.session_id).toBe(parserContext.sessionId);
+    expect(parsed.role).toBe(parserContext.role);
+    expect(parsed.feature_id).toBe(parserContext.featureId);
+    expect(parsed.outputs).toEqual([{ type: 'PATCH', unified_diff: 'diff --git a b' }]);
+    expect(parsed.provider_meta).toEqual({
+      provider: parserContext.provider,
+      model: parserContext.model,
+    });
+  });
+
+  it('GIVEN_single_output_shape_WHEN_parse_THEN_wraps_it_as_outputs_array', () => {
+    const parser = new GenericCliOutputParser();
+    const parsed = parser.parse(
+      JSON.stringify({
+        session_id: 'session-explicit',
+        role: 'qa',
+        feature_id: 'feature-explicit',
+        type: 'NOTE',
+        content: 'done',
+      }),
+      parserContext,
+    );
+    expect(parsed.session_id).toBe('session-explicit');
+    expect(parsed.role).toBe('qa');
+    expect(parsed.feature_id).toBe('feature-explicit');
+    expect(parsed.outputs).toEqual([
+      {
+        session_id: 'session-explicit',
+        role: 'qa',
+        feature_id: 'feature-explicit',
+        type: 'NOTE',
+        content: 'done',
+      },
+    ]);
+  });
+});
+
+describe('ApiWorkerProvider', () => {
+  it('GIVEN_missing_provider_config_ref_WHEN_runWorker_THEN_throws_runtime_unavailable', async () => {
+    const provider = new ApiWorkerProvider(makeSelection('gemini'), {
+      outputParser: new GenericCliOutputParser(),
+      workerResponseTimeoutMs: 1000,
+    });
+    try {
+      await provider.runWorker({
+        role: 'builder',
+        feature_id: 'feature-a',
+      });
+      throw new Error('expected runWorker to throw');
+    } catch (error) {
+      expect(error).toMatchObject({
+        code: ERROR_CODES.PROVIDER_RUNTIME_UNAVAILABLE,
+        details: { reason: 'missing_provider_config_ref' },
+      });
+    }
+  });
+
+  it('GIVEN_no_mock_response_WHEN_runWorker_THEN_throws_runtime_unavailable', async () => {
+    const provider = new ApiWorkerProvider(
+      makeSelection('gemini', {
+        provider_config_ref: 'token',
+        agent_config: {},
+      }),
+      {
+        outputParser: new GenericCliOutputParser(),
+        workerResponseTimeoutMs: 1000,
+      },
+    );
+    try {
+      await provider.runWorker({
+        role: 'builder',
+        feature_id: 'feature-a',
+      });
+      throw new Error('expected runWorker to throw');
+    } catch (error) {
+      expect(error).toMatchObject({
+        code: ERROR_CODES.PROVIDER_RUNTIME_UNAVAILABLE,
+        details: { reason: 'missing_api_adapter_configuration' },
+      });
+    }
+  });
+
+  it('GIVEN_mock_response_WHEN_runWorker_THEN_parses_and_returns_envelope', async () => {
+    const parse = vi.fn(
+      (): WorkerOutputEnvelope => ({
+        session_id: 'builder-feature-a-api',
+        role: 'builder',
+        feature_id: 'feature-a',
+        outputs: [{ type: 'NOTE', content: 'ok' }],
+        provider_meta: { provider: 'gemini', model: 'gemini-model' },
+      }),
+    );
+    const parser: ProviderOutputParser = { parse };
+    const provider = new ApiWorkerProvider(
+      makeSelection('gemini', {
+        provider_config_ref: 'token',
+        agent_config: {
+          mock_response: {
+            outputs: [{ type: 'NOTE', content: 'ok' }],
+          },
+        },
+      }),
+      {
+        outputParser: parser,
+        workerResponseTimeoutMs: 1000,
+      },
+    );
+
+    const result = await provider.runWorker({
+      role: 'builder',
+      feature_id: 'feature-a',
+    });
+
+    expect(parse).toHaveBeenCalledTimes(1);
+    expect(result).toMatchObject({
+      session_id: 'builder-feature-a-api',
+      role: 'builder',
+      feature_id: 'feature-a',
+    });
+  });
+
+  it('GIVEN_session_methods_WHEN_called_THEN_behave_deterministically', async () => {
+    const provider = new ApiWorkerProvider(makeSelection('gemini'), {
+      outputParser: new GenericCliOutputParser(),
+      workerResponseTimeoutMs: 1000,
+    });
+    const created = await provider.createSession('planner', 'feature-a', 'prompt');
+    expect(created.system_prompt_loaded).toBe(true);
+    expect(await provider.reattachSession('unknown')).toBeNull();
+    expect(await provider.reattachSession('session-2')).toMatchObject({ session_id: 'session-2' });
+    expect(await provider.closeSession('session-2')).toEqual({ closed: true });
+  });
+});
+
+describe('CliWorkerProvider', () => {
+  it('GIVEN_missing_run_template_WHEN_runWorker_THEN_throws_runtime_unavailable', async () => {
+    const commandRunner = {
+      run: vi.fn(),
+    };
+    const provider = new CliWorkerProvider(makeSelection('custom'), {
+      outputParser: new GenericCliOutputParser(),
+      commandRunner,
+      workerResponseTimeoutMs: 1000,
+    });
+    await expect(
+      provider.runWorker({
+        role: 'builder',
+        feature_id: 'feature-a',
+      }),
+    ).rejects.toMatchObject({
+      code: ERROR_CODES.PROVIDER_RUNTIME_UNAVAILABLE,
+      details: { reason: 'missing_run_command_template' },
+    });
+    expect(commandRunner.run).not.toHaveBeenCalled();
+  });
+
+  it('GIVEN_codex_selection_WHEN_runWorker_THEN_uses_default_template_and_env_and_parser', async () => {
+    const run = vi.fn(
+      async (
+        _command: string,
+        _args: string[],
+        _options?: Record<string, unknown>,
+      ): Promise<ProviderCommandResult> => ({
+        exitCode: 0,
+        signal: null,
+        stdout: JSON.stringify({
+          outputs: [{ type: 'NOTE', content: 'ok' }],
+        }),
+      }),
+    );
+    const parse = vi.fn(
+      (): WorkerOutputEnvelope => ({
+        session_id: 'planner-feature-a-session',
+        role: 'planner',
+        feature_id: 'feature-a',
+        outputs: [{ type: 'NOTE', content: 'ok' }],
+        provider_meta: { provider: 'codex', model: 'codex-model' },
+      }),
+    );
+    const provider = new CliWorkerProvider(
+      makeSelection('codex', {
+        provider_config_env: 'CODEX_TOKEN',
+        provider_config_ref: 'secret',
+      }),
+      {
+        outputParser: { parse },
+        commandRunner: { run },
+        workerResponseTimeoutMs: 2222,
+      },
+    );
+
+    const session = await provider.createSession('planner', 'feature-a', 'prompt');
+    const result = await provider.runWorker({
+      role: 'planner',
+      feature_id: 'feature-a',
+      instructions: 'do work',
+    });
+
+    expect(result).toMatchObject({
+      role: 'planner',
+      feature_id: 'feature-a',
+    });
+    expect(run).toHaveBeenCalledTimes(1);
+    const firstCall = run.mock.calls.at(0);
+    expect(firstCall).toBeDefined();
+    expect(firstCall?.[0]).toBe('codex');
+    expect(firstCall?.[1]).toContain(session.session_id);
+    const options = firstCall?.[2] as
+      | { stdin?: string; timeoutMs?: number; env?: NodeJS.ProcessEnv }
+      | undefined;
+    expect(options.timeoutMs).toBe(2222);
+    expect(options.env?.CODEX_TOKEN).toBe('secret');
+    expect(parse).toHaveBeenCalledTimes(1);
+  });
+
+  it('GIVEN_nonzero_run_exit_WHEN_runWorker_THEN_throws_runtime_unavailable', async () => {
+    const provider = new CliWorkerProvider(makeSelection('codex'), {
+      outputParser: new GenericCliOutputParser(),
+      commandRunner: {
+        run: vi.fn(async () => ({
+          exitCode: 2,
+          signal: null,
+          stderr: 'failed',
+        })),
+      },
+      workerResponseTimeoutMs: 1000,
+    });
+    await expect(
+      provider.runWorker({
+        role: 'builder',
+        feature_id: 'feature-a',
+      }),
+    ).rejects.toMatchObject({
+      code: ERROR_CODES.PROVIDER_RUNTIME_UNAVAILABLE,
+      details: { exit_code: 2 },
+    });
+  });
+
+  it('GIVEN_attach_and_send_templates_WHEN_commands_succeed_THEN_methods_are_available', async () => {
+    const run = vi.fn(
+      async (
+        _command: string,
+        _args: string[],
+        _options?: Record<string, unknown>,
+      ): Promise<ProviderCommandResult> => ({
+        exitCode: 0,
+        signal: null,
+        stdout: '{}',
+      }),
+    );
+    const provider = new CliWorkerProvider(
+      makeSelection('custom', {
+        agent_config: {
+          run: {
+            command: 'worker-cli',
+            args: ['run', '{session_id}', '{prompt}'],
+          },
+          attach_command: 'worker-cli',
+          attach_args: ['attach', '{session_id}'],
+          send: {
+            command: 'worker-cli',
+            args: ['send', '{session_id}', '{message}'],
+          },
+        },
+      }),
+      {
+        outputParser: new GenericCliOutputParser(),
+        commandRunner: { run },
+        workerResponseTimeoutMs: 1000,
+      },
+    );
+
+    expect(provider.attachToSession).toBeTypeOf('function');
+    expect(provider.sendMessage).toBeTypeOf('function');
+    expect(provider.getSessionInfo).toBeTypeOf('function');
+
+    await provider.attachToSession?.('session-a');
+    await provider.sendMessage?.('session-a', 'hello');
+    const info = await provider.getSessionInfo?.('session-a');
+    const unknownInfo = await provider.getSessionInfo?.('unknown');
+
+    expect(info).toEqual({ active: true, provider: 'custom' });
+    expect(unknownInfo).toEqual({ active: false, provider: 'custom' });
+
+    const attachCall = run.mock.calls.at(0);
+    const attachOptions = attachCall?.[2] as
+      | { interactive?: boolean; timeoutMs?: number }
+      | undefined;
+    expect(attachOptions?.interactive).toBe(true);
+    const sendCall = run.mock.calls.at(1);
+    const sendOptions = sendCall?.[2] as { interactive?: boolean; timeoutMs?: number } | undefined;
+    expect(sendOptions?.timeoutMs).toBe(15_000);
+  });
+
+  it('GIVEN_attach_command_not_found_WHEN_attach_called_THEN_throws_unsupported_provider', async () => {
+    const provider = new CliWorkerProvider(
+      makeSelection('custom', {
+        agent_config: {
+          run: { command: 'worker-cli', args: ['run', '{session_id}', '{prompt}'] },
+          attach: { command: 'worker-cli', args: ['attach', '{session_id}'] },
+        },
+      }),
+      {
+        outputParser: new GenericCliOutputParser(),
+        commandRunner: {
+          run: vi.fn(async () => ({
+            exitCode: 127,
+            signal: null,
+            errorCode: 'ENOENT',
+          })),
+        },
+        workerResponseTimeoutMs: 1000,
+      },
+    );
+
+    await expect(provider.attachToSession?.('session-a')).rejects.toMatchObject({
+      code: ERROR_CODES.UNSUPPORTED_AGENT_PROVIDER,
+    });
+  });
+
+  it('GIVEN_send_command_general_failure_WHEN_send_called_THEN_throws_internal_error', async () => {
+    const provider = new CliWorkerProvider(
+      makeSelection('custom', {
+        agent_config: {
+          run: { command: 'worker-cli', args: ['run', '{session_id}', '{prompt}'] },
+          send_command: 'worker-cli',
+          send_args: ['send', '{session_id}', '{message}'],
+        },
+      }),
+      {
+        outputParser: new GenericCliOutputParser(),
+        commandRunner: {
+          run: vi.fn(async () => ({
+            exitCode: 1,
+            signal: null,
+            errorCode: 'EFAIL',
+          })),
+        },
+        workerResponseTimeoutMs: 1000,
+      },
+    );
+
+    await expect(provider.sendMessage?.('session-a', 'msg')).rejects.toMatchObject({
+      code: ERROR_CODES.INTERNAL_ERROR,
+    });
+  });
+
+  it('GIVEN_session_lifecycle_WHEN_created_reattached_closed_THEN_session_state_is_consistent', async () => {
+    const provider = new CliWorkerProvider(makeSelection('codex'), {
+      outputParser: new GenericCliOutputParser(),
+      commandRunner: {
+        run: vi.fn(async () => ({
+          exitCode: 0,
+          signal: null,
+          stdout: JSON.stringify({
+            outputs: [{ type: 'NOTE', content: 'ok' }],
+          }),
+        })),
+      },
+      workerResponseTimeoutMs: 1000,
+    });
+
+    const created = await provider.createSession('builder', 'feature-a', null);
+    expect(created.system_prompt_loaded).toBe(false);
+    expect(await provider.reattachSession('unknown')).toBeNull();
+    expect(await provider.reattachSession('session-b')).toMatchObject({ session_id: 'session-b' });
+    expect(await provider.closeSession(created.session_id)).toEqual({ closed: true });
+  });
+});

package/apps/control-plane/test/worker-provider-factory.spec.ts

@@ -0,0 +1,151 @@
+import { describe, expect, it } from 'vitest';
+import { ERROR_CODES } from '../src/core/error-codes.js';
+import { ApiWorkerProvider } from '../src/providers/api-worker-provider.js';
+import { CliWorkerProvider } from '../src/providers/cli-worker-provider.js';
+import { NullWorkerProvider, type ProviderSelection } from '../src/providers/providers.js';
+import {
+  DefaultWorkerProviderFactory,
+  resolveMalformedWorkerOutputAction,
+  resolveNoProgressAction,
+  resolveWorkerProviderMode,
+  resolveWorkerProviderPolicy,
+  resolveWorkerProviderRuntime,
+} from '../src/providers/worker-provider-factory.js';
+
+function selection(provider: string): ProviderSelection {
+  return {
+    provider,
+    model: `${provider}-model`,
+    provider_config_env: null,
+    provider_config_ref: null,
+    agent_config: null,
+  };
+}
+
+describe('worker-provider-factory resolvers', () => {
+  it('GIVEN_cli_and_config_modes_WHEN_resolving_mode_THEN_cli_wins_then_config_then_fallback', () => {
+    expect(resolveWorkerProviderMode('live', 'stub', 'stub')).toBe('live');
+    expect(resolveWorkerProviderMode(undefined, 'stub', 'live')).toBe('stub');
+    expect(resolveWorkerProviderMode('invalid', 'invalid', 'stub')).toBe('stub');
+  });
+
+  it('GIVEN_invalid_runtime_values_WHEN_resolving_runtime_THEN_defaults_are_used', () => {
+    const runtime = resolveWorkerProviderRuntime({
+      worker_response_timeout_ms: 0,
+      max_consecutive_no_progress_iterations: -2,
+    });
+    expect(runtime.worker_response_timeout_ms).toBe(120_000);
+    expect(runtime.max_consecutive_no_progress_iterations).toBe(2);
+  });
+
+  it('GIVEN_numeric_runtime_values_WHEN_resolving_runtime_THEN_values_are_floored', () => {
+    const runtime = resolveWorkerProviderRuntime({
+      worker_response_timeout_ms: 4500.9,
+      max_consecutive_no_progress_iterations: 3.8,
+    });
+    expect(runtime.worker_response_timeout_ms).toBe(4500);
+    expect(runtime.max_consecutive_no_progress_iterations).toBe(3);
+  });
+
+  it('GIVEN_policy_input_WHEN_resolving_policy_and_actions_THEN_defaults_and_fail_run_are_supported', () => {
+    expect(resolveWorkerProviderPolicy(undefined).require_live_provider_for_run).toBe(true);
+    expect(
+      resolveWorkerProviderPolicy({ require_live_provider_for_run: false })
+        .require_live_provider_for_run,
+    ).toBe(false);
+    expect(resolveMalformedWorkerOutputAction(undefined)).toBe('block_feature');
+    expect(resolveMalformedWorkerOutputAction({ malformed_worker_output_action: 'fail_run' })).toBe(
+      'fail_run',
+    );
+    expect(resolveNoProgressAction(undefined)).toBe('block_feature');
+    expect(resolveNoProgressAction({ no_progress_action: 'fail_run' })).toBe('fail_run');
+  });
+});
+
+describe('DefaultWorkerProviderFactory', () => {
+  const factory = new DefaultWorkerProviderFactory();
+  const runtime = {
+    worker_response_timeout_ms: 2000,
+    max_consecutive_no_progress_iterations: 2,
+  };
+  const policy = { require_live_provider_for_run: true };
+
+  it('GIVEN_unsupported_provider_WHEN_create_called_THEN_throws_unsupported_provider', () => {
+    try {
+      factory.create({
+        selection: selection('bogus-provider'),
+        mode: 'live',
+        context: 'run',
+        policy,
+        runtime,
+      });
+      throw new Error('expected factory to throw');
+    } catch (error) {
+      expect(error).toMatchObject({ code: ERROR_CODES.UNSUPPORTED_AGENT_PROVIDER });
+    }
+  });
+
+  it('GIVEN_stub_mode_for_run_with_live_required_WHEN_create_called_THEN_throws_stub_disallowed', () => {
+    try {
+      factory.create({
+        selection: selection('custom'),
+        mode: 'stub',
+        context: 'run',
+        policy: { require_live_provider_for_run: true },
+        runtime,
+      });
+      throw new Error('expected factory to throw');
+    } catch (error) {
+      expect(error).toMatchObject({ code: ERROR_CODES.PROVIDER_STUB_DISALLOWED });
+    }
+  });
+
+  it('GIVEN_stub_mode_for_attach_WHEN_create_called_THEN_returns_null_worker_provider', () => {
+    const provider = factory.create({
+      selection: selection('custom'),
+      mode: 'stub',
+      context: 'attach',
+      policy: { require_live_provider_for_run: true },
+      runtime,
+    });
+    expect(provider).toBeInstanceOf(NullWorkerProvider);
+    expect(provider.mode).toBe('stub');
+  });
+
+  it('GIVEN_live_gemini_provider_WHEN_create_called_THEN_returns_api_worker_provider', () => {
+    const provider = factory.create({
+      selection: {
+        ...selection('gemini'),
+        provider_config_ref: 'token',
+      },
+      mode: 'live',
+      context: 'run',
+      policy,
+      runtime,
+    });
+    expect(provider).toBeInstanceOf(ApiWorkerProvider);
+    expect(provider.mode).toBe('live');
+  });
+
+  it('GIVEN_live_codex_provider_WHEN_create_called_THEN_returns_cli_worker_provider', () => {
+    const provider = factory.create({
+      selection: selection('codex'),
+      mode: 'live',
+      context: 'run',
+      policy,
+      runtime,
+    });
+    expect(provider).toBeInstanceOf(CliWorkerProvider);
+  });
+
+  it('GIVEN_live_custom_provider_WHEN_create_called_THEN_returns_cli_worker_provider', () => {
+    const provider = factory.create({
+      selection: selection('custom'),
+      mode: 'live',
+      context: 'send',
+      policy,
+      runtime,
+    });
+    expect(provider).toBeInstanceOf(CliWorkerProvider);
+  });
+});

package/config/agentic/orchestrator/agents.yaml

@@ -10,4 +10,7 @@ missing_prompt_behavior: ignore
 runtime:
   default_provider: claude
   default_model: local-default
+  worker_provider_mode: live
+  worker_response_timeout_ms: 120000
+  max_consecutive_no_progress_iterations: 2
   role_provider_overrides: {}

package/dist/apps/control-plane/cli/cli-argument-parser.js

@@ -94,6 +94,13 @@ export class CliArgumentParser {
                 index += 1;
                 continue;
             }
+            if (token === '--worker-provider-mode') {
+                if (next === 'live' || next === 'stub') {
+                    options.worker_provider_mode = next;
+                    index += 1;
+                }
+                continue;
+            }
             if (token === '--transport') {
                 options.transport = next;
                 index += 1;

package/dist/apps/control-plane/cli/cli-argument-parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-argument-parser.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/cli-argument-parser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-argument-parser.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/cli-argument-parser.ts"],"names":[],"mappings":"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"}

package/dist/apps/control-plane/cli/help-command-handler.js

@@ -20,6 +20,10 @@ const COMMAND_HELP = {
                 flag: '--provider-config-env <var>',
                 description: 'Env var name used for API-backed provider auth/config',
             },
+            {
+                flag: '--worker-provider-mode <live|stub>',
+                description: 'Worker execution mode override (default: live for run/resume)',
+            },
             { flag: '--transport <inprocess|mcp>', description: 'Tool transport layer (default: mcp)' },
             { flag: '--takeover-stale-run', description: 'Take over a stale run lease' },
             { flag: '--project <name>', description: 'Select project from multi-project.yaml' },
@@ -40,6 +44,10 @@ const COMMAND_HELP = {
         flags: [
             { flag: '--feature-id <id>', description: 'Resume a specific feature' },
             { flag: '--force', description: 'Force-resume even if the feature is not blocked' },
+            {
+                flag: '--worker-provider-mode <live|stub>',
+                description: 'Worker execution mode override (default: live)',
+            },
             { flag: '--transport <inprocess|mcp>', description: 'Tool transport layer (default: mcp)' },
         ],
     },