Crate scv_server 

SCV’s authoritative stdio server.

Modules

adapters

The native agent CLIs SCV can delegate to, one descriptor each.

components

Server-owned lifecycle for every long-running integration.

delegation

What SCV started, so it can list, stop, and clean up delegated agents.

imports

What scv agents import copied into an agent home, and whether its source has changed since.

overview

scv config show: every path an SCV instance uses, the settings in effect and where each came from, and whether each credential is in place. It reads files only, takes no lock a running daemon needs, and never prints a secret.

Structs

BuildInfo

What a binary reports about itself for a planned restart.

ConfigOverrides

Endpoint

An OpenAI-compatible endpoint for pi, without its key.

Enums

ApprovalPolicy

WireApi

Which OpenAI wire protocol an endpoint speaks.

Constants

CONFIG_LAYOUT

Where configuration and state files live and how they are shaped. Bump it when a release reads or writes them in a way the previous release cannot: a rollback between releases with different layouts is refused.

PI_PROVIDER

The pi provider id SCV writes for an OpenAI-compatible endpoint.

Functions

agent_command

Build a command for a native agent’s CLI with the same private home and cleaned environment the daemon’s agent_<name> tool uses, so the agent’s own sign-in stores credentials where delegated runs will find them. Project configuration cannot set [agents], so none is read.

agent_executable

Where agent’s executable resolves, as the daemon would find it.

agent_home

The prepared private agent home for agent.

agent_import_status

How agent’s imported copy compares with its source now, as one display line without secrets; None when nothing was imported.

agent_stored_status

Whether the agent’s stored credentials exist, with display lines that never contain secrets.

build_info

This binary’s build information, printed by scv build-info.

collect_agent_garbage

Remove delegated-conversation transcripts older than older_than from the agent homes (agent, or every agent that keeps them), keeping any a live conversation still uses. Returns each agent’s report.

configure_pi_endpoint

Point SCV’s pi at an OpenAI-compatible endpoint.

conversation_age

Parse a scv agents gc --older-than age such as 30d.

default_socket_path

Return the local Unix socket used by the SCV daemon and TUI.

import_codex

Copy the user’s own Codex setup from source into SCV’s private Codex agent home: config.toml, and auth.json only when it holds an API key. Returns display lines that never contain secret values.

import_grok

Copy the user’s own Grok config.toml from source (a Grok home) into SCV’s private Grok home, keeping settings only SCV’s copy has. Returns display lines that never contain secret values.

import_pi_from_scv_provider

Point SCV’s pi at SCV’s own active provider: its base URL, model, and key (read from api_key, or from the api_key_env variable now, since delegated agents never inherit key variables).

import_scv_from_scv_provider

Give the nested SCV (agent_scv) its own copy of SCV’s active provider, in $SCV_HOME/agents/scv/config.toml (mode 0600).

init_user_config

read_secret

Read a secret from the terminal without echo, or from piped stdin.

remove_agent_credentials

Remove the agent’s stored credentials from its agent home.

restart_watchdog

Restart the unit, check the new release, and roll back when it fails and the releases share a config layout. Records the outcome in the plan.

run_socket

Run the authoritative server on the local Unix socket.

run_stdio

service_name

Return the user service name for the selected SCV instance.

service_unit_path

store_agent_key

Store key in the agent’s native credential file inside its agent home.

update_index_url

user_home_path