import type { JebAnalysisPort } from "../ports/jeb/JebAnalysisPort.js"; import { parseJebMcpTimeoutMs } from "../config/environment.js"; import { ConfigurationError } from "../domain/configurationErrors.js"; import { AnalysisInputError } from "../domain/analysisErrorCore.js"; import { analysisErrorRemediationAction } from "../domain/analysisErrorPresentation.js"; import { currentAnalysisOperationSnapshot } from "../domain/analysisOperationSnapshot.js"; import { err } from "../domain/result.js"; import type { JebMcpConnectionFactory } from "../jeb/JebMcpConnection.js"; import { JebProvider } from "../jeb/JebProvider.js"; /** * Construct one JEB provider bound to the caller-selected MCP endpoint. An * unusable endpoint makes only JEB unavailable; every other CLI command and * MCP tool is composed alongside it. An invalid launch timeout stays * unavailable until the accepted operation supplies jeb.mcp_timeout_ms. */ export const createJebAnalysisProvider = ( environment: Readonly> = process.env, connectionFactory?: JebMcpConnectionFactory, ): JebAnalysisPort => { const requestTimeout = parseJebMcpTimeoutMs( environment.REA_JEB_MCP_TIMEOUT_MS, ); const build = (): JebAnalysisPort => { try { return new JebProvider({ environment, ...(requestTimeout.ok && requestTimeout.value !== undefined ? { requestTimeoutMs: requestTimeout.value, discoveryTimeoutMs: requestTimeout.value, } : {}), ...(connectionFactory === undefined ? {} : { connectionFactory }), }); } catch (cause: unknown) { if (!(cause instanceof AnalysisInputError)) throw cause; const constraint = typeof cause.cause === "string" ? cause.cause : cause.message; return unconfiguredJebProvider( new ConfigurationError("Invalid REA environment configuration", { cause, settings: [{ setting: "REA_JEB_MCP_URL", constraint }], }), ); } }; if (requestTimeout.ok) return build(); const rejected = unconfiguredJebProvider(requestTimeout.error); let provider: JebAnalysisPort | undefined; const live = (): JebAnalysisPort => (provider ??= build()); const overrideActive = (): boolean => currentAnalysisOperationSnapshot()?.overrides["jeb.mcp_timeout_ms"] !== undefined; return { inspectAvailability: (signal) => overrideActive() ? live().inspectAvailability(signal) : rejected.inspectAvailability(signal), close: () => provider === undefined ? Promise.resolve() : provider.close(), execute: (request, options) => overrideActive() ? live().execute(request, options) : rejected.execute(request, options), }; }; const unconfiguredJebProvider = ( error: ConfigurationError, ): JebAnalysisPort => { const setting = error.settings[0]?.setting ?? "REA_JEB_MCP_URL"; return { inspectAvailability: () => Promise.resolve({ status: "unavailable", code: "not_configured", reason: `${setting} is invalid: ${error.settings[0]?.constraint ?? error.message}`, remediation: analysisErrorRemediationAction(error), diagnostics: { setting }, }), close: () => Promise.resolve(), execute: () => Promise.resolve(err(error)), }; };