Function _serve

src/entrypoints/agent_server_cli.py:189–218

(args, workspace: str, agent_config: AgentServerConfig)

async def _serve(args, workspace: str, agent_config: AgentServerConfig) -> int:
    index_path = Path.home() / ".clawcodex" / "server-sessions.json"
    index_path.parent.mkdir(parents=True, exist_ok=True)

    server_config = ServerConfig(
        host=args.host,
        port=args.port,
        auth_token=args.token or "",
        workspace=workspace,
    )
    manager = SessionManager(workspace=workspace, index_path=index_path)
    spawn = make_spawn_agent(agent_config)
    server = DirectConnectServer(config=server_config, manager=manager, spawn_agent=spawn)

    await server.start()
    http_port = server.bound_http_port
    base = f"{args.host}:{http_port}"
    print(f"agent-server: protocol v{PROTOCOL_VERSION}")
    print(f"agent-server: workspace {workspace}")
    print(f"agent-server: listening on http://{base}  (POST /sessions)")
    print(f"agent-server: connect a TUI with  cc://{base}")
    if args.token:
        print("agent-server: POST /sessions requires Authorization: Bearer <token>")
    print("agent-server: Ctrl-C to stop")

    try:
        await server.serve_forever()
    finally:
        await server.stop()
    return 0


__all__ = ["run_agent_server_subcommand"]