appserver

type AppServer interface {
	// Run 服务到 ctx 结束；监听失败时提前返回，stdio 模式在输入结束或与 serve 断开时也返回。返回前关闭全部连接并等待它们的任务。
	// stdio 输入结束时返回 nil，与 serve 断开时返回 runtimeclient.ErrConnectionLost；监听模式在 ctx 结束时返回 ctx.Err()。
	Run(ctx context.Context) error
}

type AppServerOpt struct {
	// RuntimeServer 为每条连接选择要连的 serve。
	RuntimeServer RuntimeServerLocator
	// AgentName 是新建对话使用的 Agent。
	AgentName string
	// Version 写进 initialize 的 userAgent 和 Thread.cliVersion。
	Version string
	// ConfigDirectory 作为 initialize 的 codexHome 返回。
	ConfigDirectory string
	Telemetry       *telemetry.Telemetry
	// PathMappings 把 Codex 客户端给的目录换成 serve 路径（新建对话的 cwd、skills/list、thread/list 的筛选），
	// 再把对话归属的目录换回客户端路径写进 Thread 的 cwd；其他路径原样返回。
	PathMappings config.PathMappings
	// Input、Output 是 stdio 模式的协议流，每行一条 JSON。
	Input  io.ReadCloser
	Output io.WriteCloser
	// Listener 非空时改为监听模式，按 WebSocket 收发。
	Listener net.Listener
}

type RuntimeServerInfo struct {
	URL   string
	Token string // 为空时沿用 URL 里的 ?token=
	// Source 是地址的来源：--url、client.url 或 local，写进连接日志。
	Source string
	// LocalServerID 是本机 runtime-server.yaml 里的 server_id，文件不存在或读不出来时为空；
	// 连上后和 serve 返回的 server_id 比较，判断连的是不是本机 serve。
	LocalServerID string
}

type RuntimeServerLocator interface {
	// GetRuntimeServer 返回地址、token、地址来源和本机 server_id；本机 serve 没在运行时启动它。
	GetRuntimeServer(ctx context.Context) (RuntimeServerInfo, error)
}