fermilink.providers module

fermilink.providers.build_exec_command(*, provider=DEFAULT_PROVIDER, provider_bin, repo_dir, prompt, sandbox_policy=DEFAULT_SANDBOX_POLICY, sandbox_mode=None, model=None, reasoning_effort=None, json_output=True)[source]

Build a provider-specific command for one exec/chat invocation.

Parameters:

  • provider (str) – Provider identifier (for example codex, claude, gemini, or deepseek).

  • provider_bin (str) – Executable or command name used to run the provider.

  • repo_dir (Path) – Workspace repository path receiving overlaid entries.

  • prompt (str) – Prompt text sent to the provider process.

  • sandbox_policy (str) – Sandbox policy override (enforce or bypass).

  • sandbox_mode (str | None) – Sandbox mode override passed to the provider runtime.

  • model (str | None) – Optional provider model override.

  • reasoning_effort (str | None) – Optional provider reasoning-effort override (low, medium, high, or xhigh).

  • json_output (bool) – Whether to request JSON output from the provider process.

Returns:

Argument vector ready to execute via subprocess.

Return type:

list[str]

fermilink.providers.collect_provider_service_env_overrides(*, cwd)[source]

Collect provider-specific service env overrides from the current process env.

Parameters:

cwd (Path)

Return type:

dict[str, str]

fermilink.providers.provider_bin_env_key(provider)[source]

Return the provider-specific environment variable used for binary overrides.

Parameters:

provider (str) – Provider identifier (for example codex, claude, gemini, or deepseek).

Returns:

Environment variable key for provider binary overrides.

Return type:

str

fermilink.providers.provider_supports_auto_compile_metadata_generation(provider)[source]

Return whether the selected provider supports auto-compile metadata generation.

Parameters:

provider (str)

Return type:

bool

fermilink.providers.resolve_provider_binary(provider, *, provider_bin_override=None)[source]

Resolve the executable name/path for the selected provider.

Parameters:

  • provider (str) – Provider identifier (for example codex, claude, gemini, or deepseek).

  • provider_bin_override (str | None) – Optional provider-specific binary override consumed by the selected agent adapter.

Returns:

Resolved executable name/path for the provider.

Return type:

str

fermilink.providers.resolve_provider_binary_override(provider, *, raw_override=None)[source]

Resolve an optional compatibility binary override for the selected provider.

Parameters:

  • provider (str) – Provider identifier.

  • raw_override (str | None) – Raw CLI/config override value preserved for backward compatibility.

Returns:

Provider-specific override value when the selected agent consumes it.

Return type:

str | None